Sign inSign up

nurefexc/rss-bridge-ntfy

By nurefexc

•Updated 4 months ago

Lightweight RSS/Atom to ntfy.sh bridge with SQLite history, image support, and flood protection.

Image
Integration & delivery
Developer tools
Monitoring & observability
0

1.7K

nurefexc/rss-bridge-ntfy repository overview

⁠Docker Overview

⁠RSS Bridge ntfy

A lightweight Python script that monitors RSS/Atom feeds and sends real-time notifications to your ntfy⁠ topics. Supports multiple configuration files, history tracking with SQLite, and advanced ntfy features.

⁠Quick Start
bash docker run -d
--name rss-ntfy-bridge
--restart always
-v (pwd)/configs:/app/configs \ -v(pwd)/rss_history.db:/app/rss_history.db
-e NTFY_URL=[https://ntfy.sh](https://ntfy.sh)
-e NTFY_TOKEN=your_token
-e SYNC_INTERVAL=600
-e TZ=Europe/Budapest
nurefexc/rss-bridge-ntfy:latest
⁠Environment Variables
VariableRequiredDefaultDescription
CONFIG_DIR❌configsDirectory for feed configuration JSON files
NTFY_URL❌https://ntfy.shFull ntfy server URL
NTFY_TOKEN❌-ntfy authentication token
DB_PATH❌rss_history.dbPath to SQLite database for history
SYNC_INTERVAL❌600Synchronization interval in seconds
TZ❌UTCSystem timezone
USER_AGENT❌Browser-like UACustom User-Agent for HTTP requests
⁠Required Mounts
PathDescription
/app/configsDirectory containing feed configuration JSON files
/app/rss_history.dbSQLite database for tracking sent entries (optional, for persistence)
⁠Ports

No ports required – only outbound HTTP connections to RSS feeds and ntfy.

⁠Features
  • 📰 Multiple Feed Support: Monitor multiple RSS/Atom feeds via JSON configs
  • 🗄️ SQLite History: Avoids duplicate notifications
  • 🖼️ Image Attachments: Automatically attaches images from feeds
  • 🏷️ Customizable Metadata: Per-feed priority, custom icons, and tags
  • 🛡️ Flood Protection: Intelligent delays based on priority
⁠Supported Architectures
  • linux/amd64
⁠Source

Tag summary

Content type

Image

Digest

sha256:a3c6b506a…

Size

28.7 MB

Last updated

4 months ago

docker pull nurefexc/rss-bridge-ntfy