SUNSET SCORE APP
Sends a push notification when tonight's sunset quality is worth watching — triggered daily by your phone's GPS, no manual checking required.
How It Works
-
Trigger
An iOS Shortcut runs automatically at noon each day, reading your current GPS coordinates and POSTing them to a GitHub Actions workflow dispatch endpoint.
-
Forecast
The GitHub Actions workflow fetches tonight's sunset quality forecast from sunsethue.com using the supplied coordinates. Timezone and local sunset time are derived automatically — no manual configuration needed when travelling.
-
Score
If the quality score is 75% or above, the workflow fires a push notification via ntfy.sh showing the score and the exact local sunset time. Below the threshold, nothing is sent.
-
Notify
The ntfy app on your phone receives the notification. Tap it to see the score — or just head outside if you're a photographer.
Workflows
The project runs two parallel workflows — one for each subscriber — so the same codebase can serve multiple people with independent notification topics.
| Workflow | Trigger | Recipient |
|---|---|---|
| sunset-check.yml | Dylan's iOS Shortcut | Dylan |
| sunset-check-brother.yml | Jonathan's iOS Shortcut | Jonathan |
Stack
- Python 3.12 — workflow compute
- astral — sunset time calculation from coordinates
- timezonefinder — derives timezone automatically from GPS coordinates
- GitHub Actions — serverless scheduling and execution (no always-on server needed)
- ntfy.sh — free, open-source push notifications with no account required
- iOS Shortcuts — daily GPS trigger and workflow dispatch