#rss #feed #discord

app rss-discord

A simple rust program to scan rss feeds and send discord pings for new events

20 releases

new 0.2.11 Dec 3, 2024
0.2.10 Oct 30, 2024
0.2.9 Jul 23, 2024
0.2.6 Mar 12, 2024
0.1.5 Mar 25, 2023

#394 in Command line utilities

Download history 9/week @ 2024-09-10 7/week @ 2024-09-17 7/week @ 2024-09-24 9/week @ 2024-10-01 123/week @ 2024-10-29 2/week @ 2024-11-05 3/week @ 2024-11-19

128 downloads per month

MIT and GPL-3.0+

20KB
124 lines

rss-discord

A simple rust program to scan rss feeds and send discord pings for new events.

Installation

Make sure you have rust installed, then clone the repo and run cargo build --release from the project root, the resulting binary will be located at ./target/release/

Usage

Run the binary with the following environment variables set:

  • WEBHOOK_URL: A discord webhook url to send the notifications to
  • FEED_URL: A url pointing to the rss feed that you want to monitor
  • FEED_NAME: A name for the rss feed
  • MESSAGE_CONTENT: Optional content for the message, useful for pinging users or roles with <@user_id> or <@&role_id>
  • FEED_IS_HTML: If this variable is set to any value, the feed description will be handled as html
  • RSS_REPLACEMENTS: A list, separated by :, where each entry specifies a replacement to apply on the embed's description with the syntax <search>/<replacement>. Backslashes are used to escape : and / characters.

I recommend running the program periodically (i.e. with cron) to receive updates of the feed. To check for updates on multiple feeds at once, create multiple cron jobs with different environment variables.

Dependencies

~16–29MB
~489K SLoC