mstaff/feinstaubalarm
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
28 commits 1 branch 0 tags 98 KiB
  • Python 94.2%
  • Dockerfile 5.8%
Find a file
Exact
Max Staff 292e7b9341
All checks were successful
Alpine base images / build-and-push (push) Successful in 16m16s
Details
Container / build-and-push (push) Successful in 5m15s
Details
Keep Kaniko auth in ignored config directory 
Assisted-by: GPT-5.5 via pi.dev
2026-06-06 21:18:37 +02:00
.forgejo
.env.example
.gitignore
docker-compose.yml
Dockerfile
download.py
main.py
Pipfile
Pipfile.lock
pyproject.toml
README.md

README.md

Feinstaubalarm

Small HTTP service that receives sensor.community-style PM2.5 readings and sends Telegram alerts with a graph when the current value is above 2× the recent average.

Configuration

Copy the example environment file and fill in your Telegram credentials:

cp .env.example .env

Required variables:

  • TELEGRAM_BOT_TOKEN - Telegram bot token from BotFather
  • TELEGRAM_CHAT_ID - chat or group ID for alerts

Run with Docker Compose

docker compose pull
docker compose up -d

The service listens on port 8080.

Endpoints:

  • POST / - submit sensor JSON containing sensordatavalues with SDS_P2
  • GET /alarm - send a manual Telegram graph/check

State is stored in ./data via the compose volume mount.