rss2discord

A simple script for posting RSS feeds to a Discord webhook.

Installation

You can install this using pipx or the like, e.g.

pipx install rss2discord

Configuration

First, set up a webhook on Discord; consult the Discord Intro to Webhooks for more information.

Then, for each webhook, create a .json file with the following format:

{
    "webhook": "https://discord.com/api/webhooks/<channel_id>/<token>",
    "database": "feed.db",

    "username": "RSS Bot",
    "avatar_url": "https://example.com/bot.png",
    "include_summary": true,
    "include_image": false,

    "feeds": [{
        "feed_url": "https://example.com/feed",
        "username": "Example Feed",
        "avatar_url": "https://example.com/image.png",
        "include_image": true,
        "content": "<@&1272615804453785631>"
    }, {
        "feed_url": "https://example.com/another_feed",
        "avatar_url": "https://example.com/another_image.png",
        "include_summary": false
    },
    "https://example.com/feed3",
    "https://example.com/feed4"
    ]
}

The schema is pretty basic; at the top level, the following keys are supported:

• webhook: the webhook URL (i.e. the channel to post to); REQUIRED

• database: The path to the file to store the information about already-seen entries; REQUIRED

• username: The display name to use for the posting bot (will default to the webhook name)

• avatar_url: An image to use as the post avatar (will default to the webhook's icon)

• include_summary: Whether to put the feed's summary text into the preview (defaults to true)

• include_image: Whether to include the primary entry image into the preview (defaults to true)

• summary_limit: The limit of how many characters to include in the post text (defaults to 512)

• content: Text to include with the update (for e.g. @notifications)

• feeds: A list of feeds to send to the channel. A feed can be just a URL, or it can be a configuration blob with the following values:

  • feed_url: The URL to the feed
  • username, avatar_url, include_summary, include_image, content: Overrides the top-level configuration

Running it

You can run rss2discord config.json and it will go ahead and post all new items to the Discord channel. rss2discord --help will give you more detailed information about how to use it.

When first setting things up, I highly recommend doing:

rss2discord config.json -nvv

to get an idea of what will happen, and

rss2discord config.json -p

to pre-populate the database with existing items so that it doesn't spam the channel, unless you like that sort of thing.