SkyAlert-ntfy is a continuation of the SkyAlert project that doesn't depend on Bluesky's DMs, instead using publicly available Bluesky APIs and the open-source push notification server ntfy.

This version handles post notifications. It receives data from Bluesky using a Jetstream endpoint, looks for posts coming from users on a predefined list, and sends notifications.

See example-config.yaml.

You'll need a system that can run Docker, either a Linux machine or a Windows machine with Docker Desktop and WSL. It's recommended to use a machine that remains on 24/7 so that you don't miss notifications. If you don't have a home server, you can get started with any mini PC or a Raspberry Pi.

The script can also be run standalone without Docker; you'll place config.yaml in a data folder relative to the script file (skyalert-ntfy-posts.py).

If you're using Docker, create a folder with a data folder (this contains config.yaml), and copy example-compose.yml to compose.yml in that folder. After adding your configuration, run docker compose up -d in that folder to start the container.

This script uses the requests, websockets, and pyyaml Python libraries.

This script relies on ntfy as a network service to send notifications, as well as Bluesky's public APIs for receiving data.

This script is licensed under the GNU GPL 3.0.