School Bell¶
Run scheduled audio and GPIO signals reliably—even when the network or central management is unavailable. Each School Bell node stores its configuration and schedule locally and operates autonomously.
Set up Python, install School Bell and prepare a node for its first run.
Create and validate configuration, schedules, manual bells and monitoring.
Roll out and manage School Bell nodes consistently with Ansible.
Quick start¶
Install School Bell, generate the example configuration and validate it before starting the service:
$ python -m pip install .
$ school-bell --demo-config > school-bell.json
$ # Edit paths, schedule and optional integrations first.
$ school-bell school-bell.json --check
New to the project? Read Architecture to understand which components run locally and which central services are optional.
Explore the documentation¶
Architecture, autonomous operation and the role of central management.
Network access, NTP, outage behavior and audio hardware requirements.
Health reporting, diagnostics and day-to-day operation.
Diagnose startup, scheduling, connectivity and audio problems.
Select BCM pins and safely test relays and a manual push button.
Coordinate bells over SSH or expose an authenticated webhook.