A Dash-based web application to control and monitor a PitPat treadmill via Bluetooth. This unofficial tool provides real-time data visualization and basic treadmill control through an intuitive web interface.
- Bluetooth connectivity to PitPat treadmills
- Real-time monitoring of treadmill metrics
- Control commands (start, stop, speed adjustments)
- Detailed status table
- Responsive Bootstrap-styled UI
- Docker support for easy deployment
- Python 3.9+ (for local installation)
- Docker (optional, for containerized deployment)
- Bluetooth-enabled device with appropriate permissions
- Clone the repository:
git clone https://github.com/azmke/pitpat-treadmill-control.git cd pitpat-treadmill-control - Install dependencies:
pip install -r requirements.txt
- Clone the repository:
git clone https://github.com/azmke/pitpat-treadmill-control.git cd pitpat-treadmill-control - Build the Docker image:
docker build -t pitpat-treadmill-control .
Start with default settings:
python main.pyCustomize with parameters:
python main.py --host 127.0.0.1 --port 8050 --debugRun with default settings (port 8050, host 0.0.0.0):
docker run -d -p 8050:8050 --name pitpat pitpat-treadmill-controlCustomize with environment variables:
docker run -d \
-p 8050:8050 \
--name pitpat \
pitpat-treadmill-control \
--host 0.0.0.0 \
--port 8050 \
--debugAccess the dashboard at http://localhost:8050 (or your specified host/port).
The dashboard displays the following treadmill metrics:
| Metric | Description | Unit |
|---|---|---|
| Cycle ID | Unique session identifier | - |
| Running State | Current state | Starting/Running/Paused/Stopped |
| Current Speed | Current speed | kph or mph |
| Target Speed | Desired speed setting | kph or mph |
| Maximum Speed | Maximum allowed speed | kph or mph |
| Current Incline | Current incline angle | Degrees (°) |
| Target Incline | Desired incline setting | Degrees (°) |
| Maximum Incline | Maximum allowed incline | Degrees (°) |
| Heart Rate | User's heart rate (if supported) | bpm |
| Distance | Total distance traveled | km or miles |
| Steps | Number of steps taken | - |
| Calories | Estimated calories burned | kcal |
| Duration | Session duration | HH:MM:SS |
| WIFI Connected | Wi-Fi connection status | True/False |
| Motor Rotation Speed | Motor speed | rpm |
| Motor Load | Motor load percentage | % |
| Serial Number | Treadmill serial number | - |
| Firmware Version | Current firmware version | - |
| Device Type | Treadmill model identifier | - |
| Unit Mode | Measurement system | Metric/Imperial |
The following commands can be sent to the treadmill:
| Command | Description | Effect |
|---|---|---|
| Start | Begins or resumes operation | Starts treadmill if stopped/paused |
| Pause | Pauses the treadmill | Pauses if running |
| Stop | Stops the treadmill | Stops if paused |
| Speed Up | Increases speed | +0.1 kph/mph if running |
| Speed Down | Decreases speed | -0.1 kph/mph if running |
The following treadmill models have been tested with this application.
- Pitpat T01 (BA04)
Help us expand this list by reporting your compatible devices via an issue or pull request:
- Ensure Bluetooth is enabled on the host system.
- For Docker on Linux, grant Bluetooth access using the
--deviceflag. Example:docker run -d -p 8050:8050 --device=/dev/rfcomm0 pitpat-treadmill-control
- Logs are stored in the
logs/directory (locally or within the container) - Rotating log files with a maximum size of 1MB and 5 backups
We welcome contributions! To get started:
- Fork the repository
- Create a feature branch:
git checkout -b feature/your-feature - Commit your changes:
git commit -m "Add your feature" - Push to the branch:
git push origin feature/your-feature - Open a Pull Request
For bugs or feature requests, please open an issue.
This project is licensed under the MIT License. See the LICENSE file for details
This project is an independent, unofficial tool and is not affiliated with, endorsed by, or associated with PitPat or JOYFIT INC. It was developed from scratch for non-commercial, personal experimentation and educational purposes, based solely on publicly observable interactions with PitPat treadmills to enable interoperability. No proprietary code, assets, or intellectual property from PitPat or JOYFIT INC have been used or incorporated. This tool is not intended to bypass security measures or violate any terms of service. This software is provided 'as-is', without any warranties, express or implied, and the author assumes no responsibility for any damage, malfunction, or warranty issues resulting from its use. Use at your own risk and ensure compliance with applicable laws and terms of service.