Skip to content
Discord RSS bot with customizable feeds
Branch: master
Clone or download
synzen Merge pull request #103 from codeinteger6/master
Fix broken contribution link on master branch
Latest commit 7de10be Apr 24, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
commands Remove debugging logs Jan 7, 2019
events Refactor to use database as source of truth for most things Dec 29, 2018
rss Add support for folder uri for update Dec 31, 2018
settings Refactored dbOps, fixed critical logic bug for sharding Mar 19, 2018
structs Fix databaseless configuration not intializing Dec 31, 2018
util Fixed broken commands when no profile exists Jan 10, 2019
.env.example Add clarification to ".env.example" Dec 26, 2018
.eslintrc.json Standardize code, add eslint for StandardJS Dec 6, 2018
.gitignore Remove duplicates Jan 3, 2019
Dockerfile Update mongo login options to prevent deprecation warning Jul 14, 2018
LICENSE Initial Commit Jan 8, 2017
Procfile Point CONTRIBUTION to main repo Apr 24, 2019
app.json Don't require "DRSS_BOT_CONTROLLER_IDS" for the app to function Dec 13, 2018
config.js Add check for process.env.DRSS_FEEDS_DEFAULT_MESSAGE Dec 27, 2018
config.json Add support for manual encoding specifications for decoding in config ( Dec 25, 2018
filesToMongo.js fix .js instead of .json Nov 19, 2018
index.js Modularized entire bot Jun 3, 2018
package-lock.json Add the ability to run dev locally using environment variables Dec 10, 2018
package.json 4.0.2 Jan 10, 2019
server-client.js Add additional server start options Dec 28, 2018
server-shard.js Add additional server start options Dec 28, 2018
server.js Add additional server start options Dec 28, 2018
update.js 4.0.2 Jan 10, 2019


Driven by the lack of comprehensive RSS bots available, I have decided to try my hand at creating one of my own. Designed with as much customization as possible for both users and bot hosters, while also (or should be) easy to understand.

All documentation can be found at

Setting Up via Cloning Repository (for most people)


Setting Up with Existing Client

The fastest way to using Discord.RSS with an existing discord.js client with npm:

npm install discord.rss
const Discord = require('discord.js')
const DiscordRSS = require('discord.rss')

const client = new Discord.Client()
const drss = new DiscordRSS.Client({ database: { uri: './sources' } }) // File-based sources instead of Mongo

drss.login(client) // Can be done before or after the client is 'ready'

or create a new client:

const DiscordRSS = require('discord.rss')

const drss = new DiscordRSS.Client({ database: { uri: './sources' } }) // Optional config overrides

There are multiple ways of integrating Discord.RSS programmatically - see here for more information. For full features, use a mongodb database.uri instead of a directory.

Built With

Core Functions

Customization Functions

Deploy to Heroku

You can deploy in a simple way to Heroku using the button below.

Deploy to Heroku

If you want to deploy manually you should go to the settings of your applications and add a "Config Var" DRSS_DISCORD_TOKEN with the token of your discord bot.


Read the contribution guidelines. All the latest updates are commited to the dev branch.

You can’t perform that action at this time.