https://github.com/bearstorm/bearstorm-training-interval-time
Multifunctional workout interval timer addon for Home Assistant using ESP32 and MQTT.
https://github.com/bearstorm/bearstorm-training-interval-time
addon custom-component esp32 fitness flask home-assistant interval-timer mqtt timer workout
Last synced: 12 months ago
JSON representation
Multifunctional workout interval timer addon for Home Assistant using ESP32 and MQTT.
- Host: GitHub
- URL: https://github.com/bearstorm/bearstorm-training-interval-time
- Owner: Bearstorm
- License: other
- Created: 2025-04-03T16:26:48.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-04-03T16:58:59.000Z (12 months ago)
- Last Synced: 2025-04-03T17:32:24.578Z (12 months ago)
- Topics: addon, custom-component, esp32, fitness, flask, home-assistant, interval-timer, mqtt, timer, workout
- Language: HTML
- Homepage: https://www.bearstorm.com
- Size: 145 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Bearstorm Training Interval Timer
**Bearstorm Training Interval Timer** is a multifunctional Home Assistant addon that controls an ESP32-based workout interval timer over MQTT. It offers a lightweight web UI integrated directly into the Home Assistant sidebar.
## 🔧 Features
- Web-based timer control panel accessible from the HA sidebar
- Customizable intervals: Work time, Rest time, Rounds
- Live training status display
- MQTT communication with ESP32 (ESPHome)
- Simple Flask backend with HTML/JS frontend
- Ready for mobile/tablet control
- Lightweight and open to contributions
## 📡 MQTT Topics
| Topic | Payload Example |
|------------------------------|-------------------------------------------|
| `bearstorm/timer/settings` | `{ "work": 45, "rest": 15, "rounds": 8 }` |
| `bearstorm/timer/command` | `"start"` / `"stop"` |
| `bearstorm/timer/status` | `{ "mode": "WORK", "round": 3, "time_left": 28 }` |
## 🚀 Quick Start
1. Copy or clone this repo into:
`/addons/local/bearstorm_timer/`
2. In Home Assistant:
Settings → Add-ons → Add-on Store → ⋮ → Repositories → select your local addon
3. Start the addon
4. Access the "Interval Timer" from the HA sidebar
5. Set your training preferences and go!
## 🤝 Contributing
We welcome contributions from the community!
You can:
- Open [Issues](https://github.com/bearstorm/bearstorm-training-interval-timer/issues)
- Submit [Pull Requests](https://github.com/bearstorm/bearstorm-training-interval-timer/pulls)
Please see our [Contributing Guide](CONTRIBUTING.md) for more information.
## ⚖️ License
This project is licensed under the **Apache License 2.0**.
If you modify or redistribute this project, **you must credit the original author (Bearstorm)** in your documentation or interface.
See [`LICENSE`](LICENSE) for full details.