Discord Commands
Last updated
Last updated
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 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.
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.
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).