pytboss 2025.12.0

Python library for interacting with PitBoss grills and smokers.

pytboss

Python 3 library for interacting with Pitboss grills and smokers.

Note that this project has no official relationship with Pitboss or Danson's. Use at your own risk.

Usage

import asyncio
from bleak import BleakScanner
from pytboss import BleConnection, PitBoss


async def state_callback(data):
    print(data)


async def main():
    ble_device = await BleakScanner.find_device_by_address(device_address)
    model = "PBV4PS2"  # Or your model. See below.
    boss = PitBoss(BleConnection(ble_device), model)
    # Subscribe to updates from the smoker.
    await boss.subscribe_state(state_callback)
    await boss.start()
    while True:
        asyncio.sleep(0.1)


asyncio.run(main())

Installation

Pip

To install pytboss, run this command in your terminal:

$ pip install pytboss

Source code

Pytboss is actively developed on Github, where the code is always available.

You can either clone the public repository:

$ git clone https://github.com/dknowles2/pytboss

Or download the latest tarball:

$ curl -OL https://github.com/dknowles2/pytboss/tarball/main

Once you have a copy of the source, you can embed it in your own Python package, or install it into your site-packages easily:

$ cd pytboss
$ python -m pip install .

Supported Models

The following models should be supported. Note however that only the PBV4PS2 model has been tested.

• Lexington Wi-Fi Upgrade
• PB0500SP
• PB0820SP/SPW
• PB1000D3
• PB1000NC1
• PB1000NXW
• PB1000PL
• PB1000R1
• PB1000R2
• PB1000S1
• PB1000SC1
• PB1000SC2
• PB1000SP
• PB1000T1
• PB1000T2
• PB1000T3
• PB1000T4
• PB1000XL/PB1000SC3
• PB1000XLW1 (Austin XL)
• PB1020CS2
• PB1020NXW
• PB1100HTC
• PB1100PS1
• PB1100PSC1
• PB1100PSC2
• PB1100PSC3
• PB1100SP/SPW
• PB1100SPW2
• PB1150 PS3
• PB1150DX
• PB1150G/GW
• PB1150PS2
• PB1150PS3
• PB1230
• PB1230CS1
• PB1230G/GW
• PB1230SP/SPW
• PB1250 CS2
• PB1250 NX
• PB1250 PL
• PB1250CS
• PB1250CS2
• PB1250NX
• PB1250PL
• PB1285KC
• PB1285PC
• PB1300 M
• PB1300 PS4
• PB1300M
• PB1300PS4
• PB1450CS
• PB1500NXW
• PB1600 CS
• PB1600 CS2
• PB1600 M
• PB1600 PSE
• PB1600AMB
• PB1600CS
• PB1600CS2
• PB1600CST
• PB1600M
• PB1600PS1
• PB1600PS2
• PB1600PS3
• PB1600PS3_
• PB1600PSE
• PB1600SPW
• PB1600SPW2
• PB2180LK
• PB340
• PB340TGW1 (Tailgator)
• PB440D
• PB440D2
• PB440D3/PB456D
• PB440TG1
• PB440TGNC1
• PB440TGR1
• PB550G
• PB700D
• PB700FB
• PB700FBM2
• PB700FBW2 (Classic)
• PB700NC1
• PB700R1
• PB700R2
• PB700S
• PB700S1
• PB700S2
• PB700SC
• PB700T1
• PB820CS1
• PB820D
• PB820D2
• PB820D3
• PB820D4
• PB820FB
• PB820FBC
• PB820PS1
• PB820S
• PB820SC
• PB820T1
• PB820XL/PB820ME
• PB850AMB
• PB850CS1
• PB850CS2
• PB850DX
• PB850G/GW
• PB850M
• PB850PS2
• PB850SPW2
• PBV3 M
• PBV3M
• PBV3NX
• PBV4DX
• PBV4NXW
• PBV4PS2
• PBV5 P2
• PBV5CS
• PBV5P2
• PBV5PL
• PBV6 M
• PBV6 PSE
• PBV6M
• PBV6PSE
• PBV7PW1