Discorss - RSS to Discord Webhook Notifier

This Python script monitors Git Release RSS feeds and sends notifications to a Discord webhook when new updates are published. It uses a configuration file for easy management of RSS URLs and the Discord webhook URL.

Features

• RSS Feed Monitoring: Checks multiple RSS feeds at a specified interval.
• Discord Webhook Integration: Sends notifications to a Discord channel via a webhook.
• Post Caching: Prevents duplicate notifications by caching processed post IDs.
• Configurable RSS URLs and Webhook: Uses a config.ini file for easy configuration.
• Post Age Filtering: Only sends notifications for posts published within a specified time frame.

Prerequisites

• Python 3.6 or higher
• feedparser library
• requests library
• configparser library
• python-dateutil library

Installation

1. Clone the repository:

   git clone https://github.com/stanrc85/discorss.git
   cd discorss

2. Install the required Python libraries:

   pip install -r requirements.txt

Configuration

Confirmed works with GitHub and Gitea release RSS feeds.

1. GitHub

   Go to the repository releases page and then add .atom to the URL to view the RSS feed. Add that URL in the config.ini.

2. Gitea

   Go to the repository releases page and then click the RSS feed icon. Add that URL in the config.ini.

3. Create config.ini:

   Copy config.ini.example to config.ini and modify as needed:

   [RSS]
   urls =
       https://example.com/rss1
       https://example.com/rss2
   
   [Discord]
   webhook_url = YOUR_DISCORD_WEBHOOK_URL
   
   [General]
   # Check for updates every 300 seconds, set to 0 to run once and then quit (when using in a scheduled task)
   CHECK_INTERVAL = 300  
   # Only alert on posts younger than 1 day.
   MAX_POST_AGE_DAYS = 1 

   • Add your RSS feed URLs under the [RSS] section, one per line.
   • Replace YOUR_DISCORD_WEBHOOK_URL with your actual Discord webhook URL.
   • Configure CHECK_INTERVAL and MAX_POST_AGE_DAYS as desired.

Usage

1. Run the script:

   python discorss.py

2. The script will run continuously, checking the RSS feeds at the specified interval and sending notifications to your Discord channel.

Running as a Service

To run the script as a background service:

• Linux/macOS: Use nohup or screen or systemd or pm2.
• Windows: Use Task Scheduler.

Example using nohup (Linux/macOS):

nohup python discorss.py &

Running in a Docker Container

1. Build the Docker image

Open a terminal in the directory containing the Dockerfile and run:

docker build -t discorss .

2. Run the Docker container

You can now run the Docker container using the following command:

docker run -d --name discorss \
    -v $(pwd)/config.ini:/app/config.ini \
    -v $(pwd)/rss_cache.json:/app/rss_cache.json \
    discorss

Running with Cron

Set CHECK_INTERVAL = 0 in config.ini

1. Edit crontab

crontab -e

2. Add new entry

Run script every hour

0 * * * * python discorss.py