fcmless free from fcm fff
Find a file
2026-07-02 04:01:13 +02:00
.env.example Use python3-dbus for notifications with SailfishOS lock screen hints 2026-03-06 22:07:22 +01:00
.gitignore Add .env support, switch to SailfishOS focus detection via D-Bus 2026-03-06 21:21:10 +01:00
discord_notif_daemon.py cleanup init, env load 2026-07-02 04:01:13 +02:00
discord_notif_daemon.service Fix service WorkingDirectory path to include gitclones 2026-03-06 22:27:18 +01:00
README.md Add systemd service file and update README for usage instructions 2025-08-06 21:27:57 +02:00
requirements.txt first commit 2025-08-06 21:19:10 +02:00

Discord Notification Daemon

A Python-based daemon that connects to the Discord Gateway to listen for messages and sends desktop notifications for "pings" eg. mentions, messages in "trusted" channels, or direct messages.

Trusted channels are configured by taking a bunch of channel ids and putting them into the trusted_channels.txt file within the .config/discord_notification_daemon folder, created at runtime (Folder and file). Channel id's can be added at runtime, you can add comments by placing a "#" at the start of the line. ALL MESSAGES SENT INTO THE TRUSTED CHANNELS WILL TRIGGER A NOTIFICATION!!! The reason this is needed is that this only connects to the discord websocket, and i dont have discord's internal api working so i cant see if the user has permission to ping use @everyone or @here.

Theres also a systemd service file in the repo, you'll have to change the path to the file to use it.

Usecase

Im going to be using this script on my Pixel 3a running postmarketOS. Theres no discord client for linux mobile that has background notification support right now so made this to get background notifications, thats why it turns itself off if it sees dissent running.

Features

  • Connects to the Discord Gateway using WebSocket.
  • Sends desktop notifications for:
    • Mentions.
    • Messages in trusted channels.
    • Direct messages (DMs) and group DMs (GDMs).
  • Caches user avatars locally for notifications.

Requirements

  • Python 3.8 or higher.
  • Desktop environment that supports notifications.
  • Wont work on windows without small tweaks to paths in code

Installation

pip install -r requirements.txt