https://github.com/kyletryon/sentry-alert-tx-1
A retro-style beeper for Sentry.io alerts based on the ESP32-S3 TFT Adafruit Feather
https://github.com/kyletryon/sentry-alert-tx-1
Last synced: 10 months ago
JSON representation
A retro-style beeper for Sentry.io alerts based on the ESP32-S3 TFT Adafruit Feather
- Host: GitHub
- URL: https://github.com/kyletryon/sentry-alert-tx-1
- Owner: KyleTryon
- Created: 2025-08-09T00:00:49.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-26T17:36:35.000Z (10 months ago)
- Last Synced: 2025-08-27T00:36:25.226Z (10 months ago)
- Language: C++
- Size: 19.1 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
README
# Alert TX-1: Retro 80's Beeper
Alert TX-1 is a retro-inspired beeper built on the [Adafruit ESP32-S3 Reverse TFT Feather](https://www.adafruit.com/product/5691). It receives alerts from Sentry.io (via an MQTT bridge) and displays them with customizable sound, LED feedback, and an interactive UI featuring games and themes.
## Quick Start
```bash
cd AlertTX-1
make python-deps # install Python deps
make libraries # install Arduino libraries
make upload # build + upload (auto-detect board)
make dev # optional: upload + serial monitor
```
Configure Wi‑Fi/MQTT through the on-device settings menu (persisted in NVS).
## Features
- **Alert System**: Real-time Sentry alerts via MQTT with visual and audio notifications
- **Interactive UI**: Component-based framework with screens, menus, and navigation
- **Built-in Games**: BeeperHero (rhythm game), Pong, and Snake
- **Customization**: Multiple themes, 16+ ringtones (RTTTL format)
- **Power Management**: Battery support with sleep modes
## Documentation
Comprehensive guides in `AlertTX-1/docs/`:
### Setup & Hardware
- [quick-start.md](AlertTX-1/docs/setup/quick-start.md) – Get running in 5 minutes
- [hardware-setup.md](AlertTX-1/docs/setup/hardware-setup.md) – Detailed assembly
- [pinout-reference.md](AlertTX-1/docs/setup/pinout-reference.md) – Wiring diagram
- [display-troubleshooting.md](AlertTX-1/docs/setup/display-troubleshooting.md) – Display fixes
### Development
- [ui-framework.md](AlertTX-1/docs/development/ui-framework.md) – UI component system
- [navigation-system.md](AlertTX-1/docs/development/navigation-system.md) – Screen management
- [game-development.md](AlertTX-1/docs/development/game-development.md) – Create custom games
- [api-reference.md](AlertTX-1/docs/development/api-reference.md) – Complete API docs
### Features
- [ringtone-system.md](AlertTX-1/docs/features/ringtone-system.md) – RTTTL ringtones
- [theme-system.md](AlertTX-1/docs/features/theme-system.md) – Visual themes
- [power-management.md](AlertTX-1/docs/features/power-management.md) – Battery optimization
## 3D Printed Case
The `STLs/` directory contains files for a custom case for this build
This is designed for resin 3D printers, as FDM is unlikely to be high enough quality at this scale.
## Backend Service
The `Beeper-Service/` directory contains a Node.js/TypeScript service that bridges Sentry webhooks to MQTT. See its [README](Beeper-Service/README.md) for deployment instructions.