Discord Commands

Each command must start with the prefix defined in your configuration. The default prefix is rss.. For example, rss.add, rss.text, etc.

Message content intent must be enabled for the bot to read Discord messages aind respond to commands. This option can be found in Discord's control panel. See the image below.

Commands have been disabled on the public bot because of Discord's breaking permission changes. All functions must be done either through the current control panel at https://monitorss.xyz or the newer one at https://my.monitorss.xyz

Argument Definitions

* - Add anything.

content - Add content after the command.

(a|b|c) - Select a or b or c and add it after the command.

[content] - Same as above, but optional.

<content> - Replace content with the information requested.

Bot Owner Commands

Bot owners are specified through the config ownerIDs via user IDs. This is only for bot administrators/hosters to use - not server owners. See config for details.

Command

Arguments

Description

setpresence

(online|invisible|dnd|idle) (PLAYING|STREAMING|LISTENING

WATCHING|CUSTOM_STATUS) <activity_name> [<stream_url>]

Set to null to remove the presence. Rate limited by Discord.

setavatar

<url/file name>

Change the bot's avatar. Rate limited at 2 requests/10-15 min by Discord.

setusername

*

USE SPARINGLY! Change the bot's username. Heavily rate limited at 2 requests/hour by Discord.

blacklist/unblacklist

Have the bot ignore any commands from a certain guild and remove all feeds from the guild if any exists.

debug

<feed ID>

Show debug logs that track the request and response of every feed fetch as well as the comparison result of every database article against the articles in the feed from the response. This does not persist across reboots. To get the feed ID, use the backup command.

undebug

<feed ID>

Disable debug logs for a feed.

setstatus

Change the bot's status. Must be "online", "idle", "invisible", or "dnd" (case sensitive).

restore

<guild id>

Restore a guild's from an attached JSON file (created by the backup command). You must attach the guild's JSON file alongside this command. Attach the file first, then type the command in the popup box.

kill

Exit all processes with status code 1.

listguilds

Attach a file listing all the guilds the bot is in, sorted by number of members.

Guild Manager Commands

For anyone with "Manage Channel" permission in the guild, or in a channel.

Command

Arguments

Description

add

Add feeds for that specific channel. Can add multiple links separated by >.

alert

(add|remove) <user id/mention>

Specify users that should be notified when a feed has failed. Adding a user disables guild channel notifications.

backup

Backup the server's profile into an attached JSON file. To restore it, you must be a controller and use the restore owner command.

clone

Clone a feed's settings to other feed(s).

compare

<properties>

Add n/p-comparisons to a feed.

date

Opens a menu for date/timezone customizations only applicable if {date} placeholders are used.

dump

Opens a menu to send a text file showing the available raw placeholders of a feed for use.

embed

Opens a menu to set embed properties to be sent in addition to its regular text.

embed.fields

Opens a menu to control fields with your embed(s).

filters

Opens a menu to add or remove filters for specific categories for a feed.

help

List all the commands.

invite

Show the invite links for the bot.

list

[<channel mention>] [query]

Show the list of feeds in all guild channels. Optionally add a channel mention and/or a search query.

locale

<locale>

Change the language text of commands if the language is available.

mention

Opens a menu to set either user or role subscribers to be mentioned for new articles of a feed is posted.

mention.filters

Opens a menu to manage filters for subscribers so they only get mentioned when its filters pass for any particular delivered article.

move

Move a feed to another channel.

options

Opens a menu for miscellaneous feed options.

prefix

Specify a guild-specific prefix to use for commands.

refresh

Make a connection attempts for a feeds to be readded to their respective cycles if they failed (config.feeds.hoursUntilFail)

remove

Opens a menu to remove feeds.

split

Open a menu to customize message splitting settings for messages that exceed the character limit.

stats

Show performance information/general stats on the bot gathered during its lifetime.

test

[simple] [latest]

Opens a menu to print out the properties for a specific RSS feed and its filter status on whether it passed (if filters exist), along with a randomly chosen feed of any age - in the defined message/embed format in config.json. Add simple to exclude test details, and/or latest to try and get the latest article.

text

Opens a menu to set the custom text message of the feed that will be sent.

version

Show the current version of the bot

webhook

Assign a webhook to send articles instead of the bot for a feed in a particular channel.

User Commands

Usable by anyone in guild.

Command

Arguments

Description

sub

Enabled/disabled by "Manage Roles" permission. Shows a list of feeds with their roles¹ that can be added to the user.

sub.filters

Manage filters applied to the user as a direct subscriber of a particular feed.

unsub

Enabled/disabled by "Manage Roles" permission. Shows a list of feeds with their respective roles² that can be removed from the user.

¹Roles that are beneath the bot's role order (handled in role settings), and are subscribed to feeds.

²Roles that are beneath the bot's role order (handled in role settings).

Last updated