View on GitHub

discord-rss-fetcher

Discord bot to post links from an RSS feed into a channel

Build status Health status

Discord RSS fetcher

A Discord bot to post the latest articles from an RSS feed into a channel, optionally mentioning a role when posting

Features

Use cases

Getting started

Invite

Setup

Use @RSS Fetcher help to view available commands

Admin only These commands require administrator permission in the Discord server

Example: @RSS Fetcher add-feed http://lorem-rss.herokuapp.com/feed?unit=second&interval=30 #rss-posts @subscribers

Permissions

The bot requires certain permissions, which you are prompted for on the invite screen. Each permission has a reason for being required, explained below.

Permission Reason
Read messages Detect when you use commands
Send messages Respond when you use commands; post new RSS links
Read message history Check if any new RSS links have been posted during downtime
Embed links Responses to ‘help’ requests use message embeds for nice formatting

Self hosting

Manually

  1. Install Node.js v10
  2. Clone the repository, or download and extract the zip file (preferrably from the release page)
  3. Create a new file config.json from a copy of config.sample.json; paste your bot token in the token field (between the quotes)
  4. Run npm run full-start to compile and run the bot
    • If you see yellow ‘WARN’ messages about peer dependencies, you can safely ignore these

Git users

If you cloned the repository with git, make sure you git reset --hard vX.Y to a specific version, as latest master isn’t always production ready!

Docker

docker run [OPTIONS] benji7425/discord-rss-fetcher

Options

Notes

Database

Need help?

I am available for contact via my support Discord server. I will always do my best to respond, however I am often busy so can’t always be available right away, and as this is a free service I may not always be able to resolve your query.

Built With

Versioning

SemVer is used for versioning; view available versions on the tags page

License

This project is licensed under the MIT License - see the LICENSE file for details