Bot Config

Configs are set in the settings/config.bot.json file, or if you're using the bot programmatically via npm, pass in the config object to override defaults as the first parameter to the constructor (see here for more info on programmatically). Configs can also be set via environment variables.

Any configs with an asterisk * beside it indicates that it is required and the bot cannot function without them. There will be a automatic check on startup for any invalid/missing configs.

Type Definitions:

Number - A non-negative integer (no quotes).

Boolean - Either true or false (no quotes).

String - Text that must be enclosed with quotes. Example: "my text"

Array[String] - Multiple strings enclosed by [ and ], separated by commas. Example: ["mythinghere", "mysecondthinghere"] or with a single item: ["myotherthing"]

Object - A JSON object.

log

Config	Type	Description
level	String	Verbosity of the logs desired. Must be "silent", "trace", "debug", "info", "owner", "warn", "error", or "fatal". Default is "info". The lower the level, the more verbose (except silent).
destination	String	Direct JSON logs to a file. Must be an absolute path. Default is "" (no file output, only console). You may use a CLI tool like pino-pretty to filter or prettify JSON logs.
linkErrs	Boolean	Log any request failures during connections to feed URLs. Default is true.
unfiltered	Boolean	Log article links/titles that wasn't sent due to failing to pass specified filters. Default is true.
failedFeeds	Boolean	Log article won't be fetched sent due to exceeding the fail limit. Default is true.
rateLimitHits	Boolean	Log when rate limits are hit within the discord.js library. Default is true.

bot

Config	Type	Description
token*	String	Bot token to login.
enableCommands	Boolean	Allow command use by people with relevant permissions. If set to false, only owners will be able to use commands. Default is true.
prefix*	String	Prefix for Discord commands. Default is rss..
status	String	Must be "online", "idle", "dnd" or "invisible". Default is "online".
activityType	String	Must be "PLAYING", "WATCHING", "LISTENING", "STREAMING" or an empty string. Default is "". Rate limited by Discord.
activityName	String	Displayed next to the activity type. Default is "". Rate limited by Discord.
streamActivityURL	String	Stream URL for "STREAMING" activityType. only YouTube and Twitch links will be accepted by Discord. Default is "". Rate limited by Discord.
ownerIDs	Array[String]	User IDs who have access to Bot Owner commands. Default is [].
menuColor	String	Sidebar color of the Discord embed menu commands, between 0 and 16777215. Must be an integer color. Default is 7833753.
deleteMenus	Boolean	Automatically delete all messages sent within a series of menus after the series has completed. This requires the bot to have Manage Messages permission. Default is true.
runSchedulesOnStart	Boolean	Fetch all feeds for all schedules on startup. If you're constantly rebooting, it might be wise to set this to false. Default is true.
exitOnSocketIssues	Boolean	Force the bot to exit if it encounters WebSocket issues. Default is true.
exitOnDatabaseDisconnect	Boolean	Force the bot to exit if MongoDB is disconnected. Default is false.
exitOnExcessRateLimits	Boolean	Force the bot to exit if 100 rate limits were hit within 60 seconds within any shards. This is used as a failsafe. Default is true.
userAgent	String	The user agent to send feed requests with. Default is "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Firefox/78.0"
feedParseTimeoutMs	Number	Milliseconds to wait for feed parsing until it times out. Default is 10000.
feedRequestTimeoutMs	Number	Milliseconds until a feed request times out. Default is 15000.

database

Config	Type	Description
uri*	String	MongoDB connection string or a directory for a databaseless configuration (both relative and absolute paths work). See here for differences. Default is "mongodb://localhost/rss".
connection	Object	The connection options object options passed through Mongoose. This can be used for other types of authentication. Irrelevant for databaseless.
articlesExpire	Number	Number of days before articles are removed from the database. This affects how the bot decides what is new or not. Set to 0 to never expire. Irrelevant for databaseless. Default is 14.
deliveryRecordsExpire	Number	Number of days before delivery records are removed from the database. These records are for debugging/historical purposes. Irrelevant for databaseless. Default is 5.

feeds

Config	Type	Description
refreshRateMinutes	Number	Check for new feeds regularly at every interval specified in minutes. If you set this too low, you risk being banned by sites for spamming them. Default is 10.
articleDequeueRate	Number	Rate that articles are sent per second, used to alleviate rate limits by Discord. Must be >0. If it is a decimal <1, then the rate is 1 article per (1/(articleDequeueRate)) seconds. If it is >1, the rate is (articleDequeueRate) per 1 second. Default is 1.
articleRateLimit	Number	Maximum number of articles to send within a channel, regardless of the number of feeds, during a cycle. Default is 0 (unlimited).
articleDailyChannelLimit	Number	Maximum number of articles to send within a channel within a day. Limit is reset every day 00:00:00 UTC. This requires config.database.deliveryRecordsExpire to be greater than 1 to work correctly. Default is 0 (unlimited).
timezone	String	This is for the {date} tag customization. To add your own timezone, use a timezone from this list under the TZ column. Default is "UTC".
dateFormat	String	Format how {date} is shown. See details here. Whatever is here, will be inside .format(<timeFormat>) Default is "ddd, D MMMM YYYY, h:mm A z".
dateFallback	Boolean	Use the current date and time if there was no published date found for an article. Default is false.
dateLanguage	String	The default language for {date} placeholders. Default is "en".
dateLanguageList	Array[String]	The list of available languages that can be changed via the date command. Default is ["en"].
max	Number	Maximum number of feeds per server. Default is 0 (unlimited).
hoursUntilFail	Number	Hours to wait until connection attempts of a feed stops after its initial failure and non-stop consecutive failures. Default is 0 (never).
notifyFail	Boolean	Notify when a feed has exceeded hoursUntilFail in all Discord channels that it is active in. Default is true.
sendFirstCycle	Boolean	Send unseen messages on the first feed cycle that were not caught during bot downtime after it has restarted. This may result in message spam after a long downtime. Default is true.
cycleMaxAge	Number	Same as defaultMaxAge except instead of initialization, it applies to articles on every cycle. Usually not necessary to change unless feeds are incorrectly formatted that puts old articles as "new". Default is 1.
defaultText*	String	If no custom message is defined for a specific feed, this will be the message the feed will fallback to.
imgPreviews	Boolean	Toggle automatic Discord image link embedded previews for image links found inside placeholders such as {description}. Default is true.
imgLinksExistence	Boolean	Remove image links found inside placeholders such as {description}. If disabled, all image src links in such placeholders will be removed. Default is true.
checkDates	Boolean	Date checking ensures that articles that are 1 day(s) old or has invalid/no pubdates are't sent. Default is true.
formatTables	Boolean	If table formatting is enabled, they should be enclosed in code blocks to ensure uniform spacing. Default is false.
directSubscribers	Boolean	Allow users to add themselves as subscribers to a feed through the sub command. Default is false.
decode	Object	Specify what encoding a particular feed has to decode it. The feed URLs are the keys, and the encoding is the value.

advanced

Only change these if you know what you're doing. The defaults already provide the best performance for small cases (less than or equal to a couple hundred URLs to request) for most server specs.

Config	Type	Description
shards	Number	Number of shards to spawn. Default is 0 (let Discord decide how many shards it should spawn).
batchSize	Number	Number of URLs in a batch concurrently requested in a forked process. Default is 400.
parallelBatches	Number	Number of batches of URLs in a run that may run in parallel. Default is 1.
parallelRuns	Number	Number of schedule runs that may run in parallel if a run starts before the last run finishes. Default is 1.

webURL

An optional config, used to show the URL in the help command.