Nedry discord bot 2.3.2
=======================
(formerly "twitch_monitor_discord_bot")
Nedry is a self-hosted discord bot with a modular plugin system. Lots of useful
behaviour is available out-of-the-box, but you can also install plugins to extend
Nedry's behaviour, or even write your own plugins.
Some out-of-the-box features include:
* Stream announcements for twitch, with highly configurable stream announcement messages
(write your own stream announcement messages with format tokens for variable data like
stream url, discord bot name, etc. and optionally disable stream announcements when
you yourself are streaming)
* Scheduled discord messages as DMs or in public channels
* Telling knock-knock jokes (and remembering jokes that are told by discord users)
* Looking something up on wikipedia (or providing a summary of a random wikipedia article)
* Interactive trivia questions (via opentdb.com)
To get started right away, see the `Quick start`_ section.
.. contents:: **Table of Contents**
Limitations
===========
* Nedry currently does not support being invited to multiple discord servers at once--
you must run one instance per discord server.
* Nedry is a self-hosted bot-- this means you have to run the python program
yourself on a machine that you control, and configure it to connect specifically
to your discord server.
Migrating from "twitch_monitor_discord_bot"
===========================================
The project name changed, but all the features that were present in "twitch_monitor_discord_bot"
are still present in "nedry". The following steps will be necessary to switch to "nedry":
* Un-install the "twitch_monitor_discord_bot" package, and install the "nedry" package
* Replace all "twitch_monitor_discord_bot" references to "nedry" (e.g. if you have a
script or another program which runs the bot). Your existing bot configuration file for
"twitch_monitor_discord_bot" will still work with nedry.
That's it!
Install
=======
Install for Python (only Python 3.9x or greater is supported) using ``pip``:
::
python -m pip install nedry
Quick start
===========
Creating the config file and starting the bot
---------------------------------------------
#. Run the package as a module with no arguments, which will create an empty configuration
file called ``default_bot_config.json`` in your current directory and exit immediately.
::
$ python -m nedry
Created default config file 'default_bot_config.json', please add required parameters
#. Most of the behaviours of this bot can be configured via discord messages while the
bot is up and running, but there are a few parameters that need to be set in the configuration
file first, to get the bot talking to twitch and to your discord server. Populate these required
parameters in the .json file:
#. ``discord_bot_api_token``: Discord bot API token must be entered here as a string.
`Create a new bot application, and generate/copy token on the "Bot" page <https://discord.com/developers/applications>`_
(NOTE: make sure to enable all Privileged Gateway Intents for your bot application).
#. ``discord_server_id``: Discord server ID (the server that you want the bot to
connect to) must be entered here as an integer.
`How to find discord user/server/message IDs <https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID->`_
#. ``discord_admin_users``: A list of discord user IDs as integers may be entered here.
Admin users have access to the full set of discord commands that the bot can accept.
At the very least, you'll probably want to add your own discord user ID here so that
you have full control of the bot.
`How to find discord user/server/message IDs <https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID->`_
#. Once all required parameters have been set in the .json file, run the package as a module
again, but this time pass your configuration file as an argument:
::
$ python -m nedry default_bot_config.json
If configured correctly, then the bot should now connect to your discord server. You're done editing the config file!
Further initial configuration: interacting with the bot on discord
------------------------------------------------------------------
Whenever your bot is online in the discord server, you can issue commands to the bot
by putting a mention of the bot's discord name at the beginning of the message, either
in a DM or in any channel the bot has access to, e.g. ``@BotName !command``. The only
command you *really* need to know is the ``help`` command;
if you say ``@BotName !help``, then the bot will show you what commands are available
and show you how to get more specific help with individual commands.
Aside from the first 3 things you set in the bot's configuration file in the previous section,
everything else about the bot's behaviour can be configured by sending messages/commands to
the bot on discord. One thing you might want configure in this way, is how twitch streamers
are monitored for stream announcements.
The following steps are required to enable twitch stream announcements:
#. **Setting which twitch streamers to monitor**
Send the "addstreamers" command, with one or more arguments, each of which must
be the name of an existing twitch channel. e.g. "@BotName !addstreamers channel1 channel2":
.. image:: images/addstreamers.png
Changes to the list of streamers are saved in the configuration file.
For information about how to view the list of streamers being monitored, and how to
remove a streamer from the list, use the "@BotName !help streamers" and "@BotName !help removestreamers"
commands.
#. **Setting the discord channel for stream announcements**
Send the "announcechannel" command with one argument, which should be the name of the discord
channel you would like stream announcements to be sent to. e.g. "@BotName !announcechannel channel-name":
.. image:: images/set_channel.png
The stream announcement channel name is saved in the configuration file.
#. **Setting custom phrases for stream announcements**
This is optional, but there is only 1 default stream announcement phrase, so
you might want to add some of your own. Each time a streamer goes live, one
of your stream announcement phrases is picked randomly for the announcement.
Phrases may contain format tokens (see the "@BotName !help addphrase" command
for more information about format tokens). e.g. "@BotName !addphrase some custom phrase":
.. image:: images/add_phrase.png
For reference, the phrase from the previous image produces the following stream announcement
when a streamer named "OhmLab" starts streaming on a Wednesday:
.. image:: images/stream_announcement.PNG
All stream announcement phrases are saved in the configuration file.
#. **Setting twitch client ID and client secret**
in a DM with the bot in discord, or in any public channel, send the "twitchclientid"
command with two arguments, e.g. "@BotName !twitchclientid xxxx yyyy".
Replace "xxxx" with your twitch client ID, and replace "yyyy" with your twitch client
secret. You must have a twitch account, and register an application, to obtain a
client ID and client secret for your application. `instructions here <https://dev.twitch.tv/docs/authentication/register-app>`_.
.. image:: images/set_twitchclientid.png
You can change the client ID and client secret at any time, using the same command.
The client ID and client secret you provide with this command is saved in the config file,
so there is no need to re-send this every time you start the bot.
Running nedry as a systemctl service
====================================
Use the `nedry.service <https://raw.githubusercontent.com/eriknyquist/nedry/master/scripts/nedry.service>`__
file available on github to quickly create a systemctl service for running nedry.
NOTE: This service loads a config file at ``/home/ubuntu/nedry_config.json``, you may
need to edit the "ExecStart" line and change that path to your config file location.
NOTE: This service loads the environment of a user named "ubuntu", you may need to
edit the "User" line and change the username to your own username.
Writing and using plugins
=========================
* In order to use plugins, you must add at least one directory path to the ``plugin_directories``
list in the configuration file. Plugins are installed by placing the python file(s) directly
in the top level of any directory listed in ``plugin_directories`` (not in a subdirectory!).
If any valid plugins exist in any the directories listed in ``plugin_directories`` when the
bot starts up, they will be loaded and available for use.
* All loaded plugins are enabled by default. To see a list of all plugins, enabled and
disabled, use the ``!plugins`` command. To disable/enable a plugin, use the
``!plugson`` and ``!plugsoff`` commands. For example, to disable the built-in
``knock_knock_jokes`` plugin, use ``@BotName !plugsoff knock_knock_jokes``.
* To get started with writing plugins, see `this sample plugin <https://github.com/eriknyquist/nedry/blob/nedry/example_plugins/echo_dm_example.py>`_.
Also, see `this more complex built-in plugin <https://github.com/eriknyquist/nedry/blob/nedry/nedry/builtin_plugins/knock_knock_jokes.py>`_
Misc. sample bot interactions
=============================
The following are some screenshots of miscellaneous command / response interactions
with the bot in discord. This section is *not* intended as a comprehensive reference
of all available commands (see the "Bot command reference" section at the end for that),
but rather a quick illustration of what it looks like to interact with the bot in discord.
Announcements for when a twitch streamer goes live
--------------------------------------------------
.. image:: images/stream_announcement.PNG
Scheduling a message in a public channel
----------------------------------------
.. image:: images/scheduled_message.PNG
Scheduling a DM reminder
------------------------
.. image:: images/reminder.PNG
Requesting a knock-knock joke from the bot
------------------------------------------
.. image:: images/tell_joke.PNG
Telling a knock-knock joke for the bot to remember
--------------------------------------------------
.. image:: images/remember_joke.PNG
Asking the bot to do a wikipedia search
---------------------------------------
.. image:: images/wiki.png
Asking the bot to make fun of the last thing someone said
---------------------------------------------------------
.. image:: images/mocking.PNG
Configuration file details
==========================
This section covers all configuration file parameters, including those not covered
in the Quick Start section. The configuration file must be a .json file of the following form:
::
{
"twitch_client_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"twitch_client_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"discord_bot_api_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"discord_server_id": 123456789123456789,
"discord_channel_name": "my-discord-channel",
"poll_period_seconds": 60,
"host_streamer": "my-twitch-streamer-name",
"silent_when_host_streaming": true,
"plugin_data": {},
"plugin_directories" : ["/home/user/nedry_plugins"],
"discord_admin_users" : [422222187366187010, 487222187346187011],
"discord_joke_tellers" : [422222187366187010, 487222187346187011],
"jokes": [],
"timezones": {},
"command_log_file" : "/home/user/twitch_monitor_bot_command_log.txt",
"startup_message": "Hello! I am a bot who can monitor twitch streams for you.",
"streamers_to_monitor": [
"mrsketi",
"none_of_many"
],
"stream_start_messages": [
"{streamer_name} is now streaming! watch it here: {stream_url}",
"{streamer_name} is doing something, go see it here: {stream_url}"
]
}
Description of fields
---------------------
* ``twitch_client_id``: Enter your Twitch client ID here.
* ``discord_bot_api_token``: Enter the API token for your discord bot application here.
* ``discord_server_id``: Enter the server ID for the server you want the bot to connect to here.
* ``discord_channel_name``: Enter the name of the channel you want the bot to connect to here.
* ``poll_period_seconds``: Enter the desired delay (in seconds) between checking if all streamers are live here.
* ``host_streamer``: Enter the name of your own twitch channel here (optional).
* ``silent_when_host_streaming``: If true, no announcements about other streams will be made when host streamer is live.
* ``plugin_directories``: List of directory names to search for plugins to load on startup
* ``plugin_data``: Holds persistent data for plugins, dict keyed by plugin name
* ``discord_admin_users``: Multiple discord user ID numbers can be added here. Users added
here will be allowed to configure the bot by sending commands in discord.
* ``discord_joke_tellers``: Multiple discord user ID numbers can be added here. Any knock-knock
jokes told to the bot by discord users in this list, will be "remembered" (stored in the "jokes"
list), and can be told back to other discord users later when a joke is requested.
* ``jokes``: Any jokes remembered by the bot from discord users will be stored here.
* ``timezones``: Dict that maps discord user ID numbers to the IANA name of the timezone they are in.
When you tell the bot your timezone with the "timezone" command, this is where it is stored.
* ``command_log_file``: Enter desired filename to log commands received from discord messages.
Set to "null" if you don't want to log commands.
* ``startup_message``: Enter the message you would like the bot to send when it comes online after being started up here.
Message may contain the following format tokens:
* ``{botname}`` : replaced with bot name that is seen by other discord users
* ``{date}`` : will be replaced with current date in DD/MM/YYY format
* ``{times}`` : will be replaced with current time in HH:MM:SS format
* ``{time}`` : will be replaced with current time in HH:MM format
* ``{day}`` : will be replaced with the name of the current weekday (e.g. "Monday")
* ``{month}`` : will be replaced with the name of the current month (e.g. "January")
* ``{year}`` : will be replaced with the current year (e.g. "2022")
* ``streamers_to_monitor``: Enter the list of streamer names to monitor here.
* ``stream_start_messages``: Multiple messages can be defined here to be used as announcements
for streamers going live. Messages may contain the following format tokens:
* ``{streamer_name}`` : will be replaced with the name of the streamer
* ``{stream_url}`` : will be replaced with the stream URL on twitch.com
* ``{botname}`` : replaced with bot name that is seen by other discord users
* ``{date}`` : will be replaced with current date in DD/MM/YYY format
* ``{times}`` : will be replaced with current time in HH:MM:SS format
* ``{time}`` : will be replaced with current time in HH:MM format
* ``{day}`` : will be replaced with the name of the current weekday (e.g. "Monday")
* ``{month}`` : will be replaced with the name of the current month (e.g. "January")
* ``{year}`` : will be replaced with the current year (e.g. "2022")
Event reference for plugins
===========================
If you are writing a plugin, you probably need to subscribe to some events (as shown
in `this example plugin <https://github.com/eriknyquist/nedry/blob/master/example_plugins/echo_dm_example.py>`_).
This section enumerates al available event types in ``nedry.event_types.events``, along
with their expected arguments and a brief description:
.. list-table:: nedry.event_types.EventType
:widths: 30 30 30
:header-rows: 1
* - Event
- Event arguments
- Event description
* - DISCORD_MESSAGE_RECEIVED
- (message)
"message" is the discord.py message object (see
`discord.py docs <https://discordpy.readthedocs.io/en/stable/api.html#discord.Message>`__)
- Emitted whenever any discord message is received, either in a public channel
which the bot has access to, or in a DM with the bot.
* - DISCORD_BOT_MENTION
- (message, text_without_mention)
"message" is the discord.py message object (see
`discord.py docs <https://discordpy.readthedocs.io/en/stable/api.html#discord.Message>`__).
"text_without_mention" is the message text with the bot mention stripped out.
- Emitted whenever any discord message that starts with a mention of the bots
discord name is received, either in a public channel which the bot has access
to, or in a DM with the bot.
* - NEW_DISCORD_MEMBER
- (member)
"member" is the discord.py User object of the member who joined
(see `discord.py docs <https://discordpy.readthedocs.io/en/stable/api.html#discord.User>`__).
- Emitted whenever a new user joins the discord server.
* - DISCORD_CONNECTED
- No arguments
- Emmitted whenever the bot is connected to the configured discord server
(this can take up to a few seconds after startup)
* - TWITCH_STREAM_STARTED
- (name, url)
"name" is the Twitch name of the streamer who started streaming.
"url" is the Twitch URL of the stream that started.
- Emitted whenever one of the streamers configured for monitoring starts streaming.
* - TWITCH_STREAM_ENDED
- (name, url)
"name" is the Twitch name of the streamer who stopped streaming.
"url" is the Twitch URL of the stream that ended.
- Emitted whenever one of the streamers configured for monitoring stops streaming.
* - HOST_STREAM_STARTED
- No arguments
- Emitted when the configured host streamer starts streaming
* - HOST_STREAM_ENDED
- No arguments
- Emitted when the configured host streamer stops streaming
Bot command reference
=====================
Command ``help``
----------------
::
help [command]
Shows helpful information about the given command. Replace [command] with the
command you want help with.
Example:
@BotName !help wiki
All discord users may use this command.
Command ``quote``
-----------------
::
quote
Displays a random famous quote
Example:
@BotName !quote
All discord users may use this command.
Command ``timezone``
--------------------
::
timezone [timezone_name]
Set the timezone for the author of the discord message, allowing this
discord user to provide/see dates and times in their local timezone.
[timezone_name] should be replaced with the name of a timezone from the IANA
time zone database, or some substring, e.g. "london" or "los angeles". If you
live in a big city, then often just typing the name of the city here will be
enough. If you are having issues, however, try selecting your region on
this IANA timezone map, and using the country/city name that is shown in
the drop-down selection box: https://kevalbhatt.github.io/timezone-picker
Sending this command with no arguments will query the timezone currently
assigned to the author of the discord message.
Example:
@BotName !timezone # Query timezone setting for this discord user
@BotName !timezone london # Set timezone for this discord user to "Europe/London"
All discord users may use this command.
Command ``streamers``
---------------------
::
streamers
Shows a list of streamers currently being monitored.
Example:
@BotName !streamers
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``addstreamers``
------------------------
::
addstreamers [name] ...
Adds one or more new streamers to list of streamers being monitored. Replace
[name] with the twitch name(s) of the streamer(s) you want to monitor.
Example:
@BotName !addstreamers streamer1 streamer2 streamer3
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``removestreamers``
---------------------------
::
removestreamers [name] ...
Removes one or more streamers from the list of streamers being monitored. Replace [name]
with the twitch name(s) of the streamer(s) you want to remove.
Example:
@BotName !removestreamers streamer1 streamer2 streamer3
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``clearallstreamers``
-----------------------------
::
clearallstreamers
Clears the list of streamers currently being monitored.
Example:
@BotName !clearallstreamers
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``phrases``
-------------------
::
phrases
Shows a numbered list of phrases currently in use for stream announcements.
Example:
@BotName !phrases
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``testphrases``
-----------------------
::
testphrases
Shows all phrases currently in use for stream announcements, with the format tokens
populated, so you can see what they will look like when posted to the discord channel.
Example:
@BotName !testphrases
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``addphrase``
---------------------
::
addphrase [phrase]
Adds a new phrase to be used for stream annnouncements. The following format
tokens may be used within a phrase:
{streamer_name} : replaced with the streamer's twitch name
{stream_url} : replaced with the stream URL on twitch.tv
{botname} : replaced with bot name that is seen by other discord users
{date} : replaced with current date in DD/MM/YYY format
{times} : replaced with current time in HH:MM:SS format
{time} : replaced with current time in HH:MM format
{day} : replaced with the name of the current weekday (e.g. "Monday")
{month} : replaced with the name of the current month (e.g. "January")
{year} : replaced with the current year (e.g. "2022")
Example:
@BotName !addphrase "{streamer_name} is now streaming at {stream_url}!"
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``removephrases``
-------------------------
::
removephrases [number] [number] ...
Removes one or more phrases from the list of phrases being used for stream announcements.
[number] must be replaced with the number for the desired phrase, as shown in the
numbered list produced by the 'phrases' command. In other words, in order to remove
a phrase, you must first look at the output of the "phrases" command to get the
number of the phrase you want to remove.
Example:
@BotName !removephrases 3 4 5
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``nocompetition``
-------------------------
::
nocompetition [enabled]
[enabled] must be replaced with either 'true' or 'false'. If true, then no
announcements about other streams will be made while the host streamer is streaming.
If false, then announcements will always be made, even if the host streamer is streaming.
(To check if nocompetition is enabled, run the command with no true/false argument)
Examples:
@BotName !nocompetition true (enable nocompetition)
@BotName !nocompetition false (enable nocompetition)
@BotName !nocompetition (check current state)
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``cmdhistory``
----------------------
::
cmdhistory [entry_count]
Show the last few entries in the command log file. If no count is given then the
last 25 entries are shown.
Examples:
@BotName !cmdhistory (show last 25 entries)
@BotName !cmdhistory 5 (show last 5 entries)
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``say``
---------------
::
say [stuff to say]
Causes the bot to send a message in the announcements channel, immediately, containing
whatever you type in place of [stuff to say].
Example:
@BotName !say Good morning
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``plugins``
-------------------
::
plugins
Show all loaded plugins, and show which ones are currently enabled
Example:
@BotName !help wiki
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``plugson``
-------------------
::
plugson [plugin_name] [plugin_name] ...
Enable / turn on one or more plugins by name (plugin names can be seen in the
output of the 'plugins' command, surrounded by square braces e.g. "[]").
Example:
@BotName !pluginon knock_knock_jokes other_plugin
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``plugsoff``
--------------------
::
plugsoff [plugin_name] [plugin_name] ...
Disable / turn off one or more plugins by name (plugin names can be seen in the
output of the 'plugins' command, surrounded by square braces e.g. "[]").
Example:
@BotName !pluginoff knock_knock_jokes other_plugin
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``pluginfo``
--------------------
::
pluginfo [plugin_name]
Query information about a loaded plugin.
Example:
@BotName !pluginfo knock_knock_jokes
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``twitchclientid``
--------------------------
::
twitchclientid [client_id_string] [client_secret_string]
Sets the client ID and client secret used to interact with the Twitch API.
Replace [client_id_string] with the client ID string for your twitch application.
Replace [client_secret_string] with the client secret string for your twitch application.
Example:
@BotName !help twitchclientid XXXXXXXXXXXX YYYYYYYYYYYY
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``announcechannel``
---------------------------
::
announcechannel [discord_channel_name]
Sets the discord channel where stream announcements will be posted. If no discord
channel name is provided, then the name of the current stream announcements channel
will be returned.
Example:
@BotName !announcechannel # Query current channel name
@BotName !announcechannel my-channel # Set announcements channel to 'my-channel'
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``joke``
----------------
::
joke
Tells an interactive knock-knock joke.
You can also *tell* knock-knock jokes to the bot, and it will remember new jokes
to tell them back to you later when you send this command.
Any discord users can tell jokes to the bot, but only jokes told by users listed
in 'discord_joke_tellers' in the configuration file will be remembered.
Example:
@BotName !joke
All discord users may use this command.
Command ``wiki``
----------------
::
wiki [search text]
Search the provided text using Wikipedia's public API, and return the summary text
(generally the first paragraph) of the first page in the search results. If no search
text is provided, then a random Wikipedia article will be selected instead.
Examples:
@BotName !wiki python language (Show summary of wiki page for Python programming language)
@BotName !wiki (Show summary of a random wiki page)
All discord users may use this command.
Command ``mock``
----------------
::
mock [mention]
Repeat the last thing said by a specific user in a "mocking" tone. Replace [mention]
with a mention of the discord user you want to mock.
Example:
@BotName !mock @discord_user
All discord users may use this command.
Command ``apologize``
---------------------
::
apologize [mention]
Apologize to a specific user for having mocked them. Replace [mention]
with a mention of the discord user you want to apologize to.
Example:
@BotName !apologize @discord_user
All discord users may use this command.
Command ``apologise``
---------------------
::
apologise [mention]
Apologize to a specific user for having mocked them. Replace [mention]
with a mention of the discord user you want to apologize to.
Example:
@BotName !apologize @discord_user
All discord users may use this command.
Command ``schedule``
--------------------
::
schedule [channel_name] [message_text] in|on|at [time_description]
Set up a message to be sent by the bot in a specific discord channel after a specific
time delay.
[channel_name] should be replaced with name of the discord channel in which you
want the message to be sent.
[message_text] should be replaced with whatever text you want to be sent in the discord message.
[time_description] should be replaced with a description of the desired time before
the message is delivered to the channel. The time can be described in one of the following ways:
- An absolute delay period written in english, using digits (e.g. "5") instead of
words (e.g. "five") for number values. For example: "1 minute", "2 hours and 3 minutes",
"2hrs3mins", "2 hours & 3 minutes"
- A specific date and time, written in one of the following formats:
* DD/MM/YYYY HH:MM
* YYYY/MM/DD HH:MM
* HH:MM DD/MM/YYYY
* HH:MM YYYY/MM/DD
NOTE: if you are using a specific date/time, you should first tell the bot which
timezone you are in using the "!timezone" command. That way, you can provide dates/times
in your local timezone. You only have to set your timezone once, the bot will
remember it (see "@BotName !help timezone" for more details about how to set your timezone).
Sending the command with no arguments returns the list of currently scheduled messages.
Examples:
@BotName !schedule # Query currently scheduled messages
@BotName !schedule jokes haha! in 2 hours # Schedule message to "jokes" in 2 hours
@BotName !schedule news raining :( in 1h & 10m # Schedule message to "news" in 1 hour, 10 mins
@BotName !schedule general howdy! at 17:02 23/10/2025 # Schedule message to "general" at specific date & time
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``unschedule``
----------------------
::
unschedule [message_number] [message_number] ...
unschedule all
unschedule last
Remove one or more scheduled messages by number. [message_number] should be replaced
with the number of the message you want to remove, as shown by the output of running the
'!schedule' command with no arguments.
Alternatively, instead of passing numbers, you can pass a single argument of "all"
to remove all scheduled messages at once, or "last" to remove the most recently
added scheduled message.
Examples:
@BotName !unschedule last # Remove last added message
@BotName !unschedule all # Remove all messages
@BotName !unschedule 2 # Remove message #2
@BotName !unschedule 5 6 # Remove messages 5 and 6
Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.
Command ``remindme``
--------------------
::
remindme [reminder_text] in|on|at [time_description]
Set up a reminder. After the specified time, the bot will send you a DM with whatever
text you provided for [reminder_text].
[reminder_text] should be replaced with whatever text you want in the reminder message,
e.g. the thing that you want to be reminded of.
[time_description] should be replaced with a description of the desired time before
the reminder is delivered. The time can be described in one of the following ways:
- An absolute delay period written in english, using digits (e.g. "5") instead of
words (e.g. "five") for number values. For example: "1 minute", "2 hours and 3 minutes",
"2hrs3mins", "2 hours & 3 minutes"
- A specific date and time, written in one of the following formats:
* DD/MM/YYYY HH:MM
* YYYY/MM/DD HH:MM
* HH:MM DD/MM/YYYY
* HH:MM YYYY/MM/DD
NOTE: if you are using a specific date/time, you should first tell the bot which
timezone you are in using the "!timezone" command. That way, you can provide dates/times
in your local timezone. You only have to set your timezone once, the bot will
remember it (see "@BotName !help timezone" for more details about how to set your timezone).
Sending the command with no arguments returns the list of active reminders
for the user that sent the command.
Examples:
@BotName !remindme # Query current reminders for me
@BotName !remindme To take out the trash... in 12 hours # schedule reminder in 12 hours
@BotName !remindme to take a shower :D in 1 day and 5 mins # Schedule reminder in 1 day and 5 minutes
@BotName !remindme to brush my teeth on 22/4/2025 14:30 # Schedule reminder at specific date & time
All discord users may use this command.
Command ``unremind``
--------------------
::
unremind [reminder_number] [reminder_number] ...
unremind all
unremind last
Remove one or more reminders by number. [reminder_number] should be replaced with the
number of the reminder you want to remove, as shown by the output of running the
'!remindme' command with no arguments.
Alternatively, instead of passing numbers, you can pass a single argument of "all"
to remove all reminders at once, or "last" to remove the last reminder that you scheduled.
Examples:
@BotName !unremind last # Remove last added reminder
@BotName !unremind all # Remove all reminders
@BotName !unremind 2 # Remove reminder #2
@BotName !unremind 5 6 # Remove reminders 5 and 6
All discord users may use this command.
Command ``trivia``
------------------
::
trivia [time_limit]
Fetch a trivia question from opentdb.com and allow all discord users to provide
an answer until the time limit is up. Whoever provides the correct answer first
gets 2 points, and any other correct answers that came after that get 1 point.
If the correct answer is not provided, then no points are awarded.
[time_limit] should be replaced with the desired time limit for the question, in seconds.
This parameter is optional; if no time limit is provided then a time limit of 60 seconds
will be used.
Example:
@BotName !trivia
All discord users may use this command.
Command ``triviascores``
------------------------
::
triviascores
Shows total score for all discord users who have ever answered a trivia question correctly.
The first correct answer to a trivia question gets 2 points, and all other correct answers
get 1 point.
Example:
@BotName !triviascores
All discord users may use this command.
Raw data
{
"_id": null,
"home_page": "http://github.com/eriknyquist/nedry",
"name": "nedry",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "",
"author": "Erik Nyquist",
"author_email": "eknyquist@gmail.com",
"download_url": "",
"platform": null,
"description": "Nedry discord bot 2.3.2\r\n=======================\r\n\r\n(formerly \"twitch_monitor_discord_bot\")\r\n\r\nNedry is a self-hosted discord bot with a modular plugin system. Lots of useful\r\nbehaviour is available out-of-the-box, but you can also install plugins to extend\r\nNedry's behaviour, or even write your own plugins.\r\n\r\nSome out-of-the-box features include:\r\n\r\n* Stream announcements for twitch, with highly configurable stream announcement messages\r\n (write your own stream announcement messages with format tokens for variable data like\r\n stream url, discord bot name, etc. and optionally disable stream announcements when\r\n you yourself are streaming)\r\n* Scheduled discord messages as DMs or in public channels\r\n* Telling knock-knock jokes (and remembering jokes that are told by discord users)\r\n* Looking something up on wikipedia (or providing a summary of a random wikipedia article)\r\n* Interactive trivia questions (via opentdb.com)\r\n\r\nTo get started right away, see the `Quick start`_ section.\r\n\r\n.. contents:: **Table of Contents**\r\n\r\nLimitations\r\n===========\r\n\r\n* Nedry currently does not support being invited to multiple discord servers at once--\r\n you must run one instance per discord server.\r\n\r\n* Nedry is a self-hosted bot-- this means you have to run the python program\r\n yourself on a machine that you control, and configure it to connect specifically\r\n to your discord server.\r\n\r\nMigrating from \"twitch_monitor_discord_bot\"\r\n===========================================\r\n\r\nThe project name changed, but all the features that were present in \"twitch_monitor_discord_bot\"\r\nare still present in \"nedry\". The following steps will be necessary to switch to \"nedry\":\r\n\r\n* Un-install the \"twitch_monitor_discord_bot\" package, and install the \"nedry\" package\r\n* Replace all \"twitch_monitor_discord_bot\" references to \"nedry\" (e.g. if you have a\r\n script or another program which runs the bot). Your existing bot configuration file for\r\n \"twitch_monitor_discord_bot\" will still work with nedry.\r\n\r\nThat's it!\r\n\r\nInstall\r\n=======\r\n\r\nInstall for Python (only Python 3.9x or greater is supported) using ``pip``:\r\n\r\n::\r\n\r\n python -m pip install nedry\r\n\r\nQuick start\r\n===========\r\n\r\nCreating the config file and starting the bot\r\n---------------------------------------------\r\n\r\n#. Run the package as a module with no arguments, which will create an empty configuration\r\n file called ``default_bot_config.json`` in your current directory and exit immediately.\r\n\r\n ::\r\n\r\n $ python -m nedry\r\n\r\n Created default config file 'default_bot_config.json', please add required parameters\r\n\r\n#. Most of the behaviours of this bot can be configured via discord messages while the\r\n bot is up and running, but there are a few parameters that need to be set in the configuration\r\n file first, to get the bot talking to twitch and to your discord server. Populate these required\r\n parameters in the .json file:\r\n\r\n #. ``discord_bot_api_token``: Discord bot API token must be entered here as a string.\r\n `Create a new bot application, and generate/copy token on the \"Bot\" page <https://discord.com/developers/applications>`_\r\n (NOTE: make sure to enable all Privileged Gateway Intents for your bot application).\r\n\r\n #. ``discord_server_id``: Discord server ID (the server that you want the bot to\r\n connect to) must be entered here as an integer.\r\n `How to find discord user/server/message IDs <https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID->`_\r\n\r\n #. ``discord_admin_users``: A list of discord user IDs as integers may be entered here.\r\n Admin users have access to the full set of discord commands that the bot can accept.\r\n At the very least, you'll probably want to add your own discord user ID here so that\r\n you have full control of the bot.\r\n `How to find discord user/server/message IDs <https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID->`_\r\n\r\n#. Once all required parameters have been set in the .json file, run the package as a module\r\n again, but this time pass your configuration file as an argument:\r\n\r\n ::\r\n\r\n $ python -m nedry default_bot_config.json\r\n\r\n\r\n If configured correctly, then the bot should now connect to your discord server. You're done editing the config file!\r\n\r\n\r\nFurther initial configuration: interacting with the bot on discord\r\n------------------------------------------------------------------\r\n\r\nWhenever your bot is online in the discord server, you can issue commands to the bot\r\nby putting a mention of the bot's discord name at the beginning of the message, either\r\nin a DM or in any channel the bot has access to, e.g. ``@BotName !command``. The only\r\ncommand you *really* need to know is the ``help`` command;\r\nif you say ``@BotName !help``, then the bot will show you what commands are available\r\nand show you how to get more specific help with individual commands.\r\n\r\nAside from the first 3 things you set in the bot's configuration file in the previous section,\r\neverything else about the bot's behaviour can be configured by sending messages/commands to\r\nthe bot on discord. One thing you might want configure in this way, is how twitch streamers\r\nare monitored for stream announcements.\r\n\r\nThe following steps are required to enable twitch stream announcements:\r\n\r\n#. **Setting which twitch streamers to monitor**\r\n\r\n Send the \"addstreamers\" command, with one or more arguments, each of which must\r\n be the name of an existing twitch channel. e.g. \"@BotName !addstreamers channel1 channel2\":\r\n\r\n .. image:: images/addstreamers.png\r\n\r\n Changes to the list of streamers are saved in the configuration file.\r\n\r\n For information about how to view the list of streamers being monitored, and how to\r\n remove a streamer from the list, use the \"@BotName !help streamers\" and \"@BotName !help removestreamers\"\r\n commands.\r\n\r\n#. **Setting the discord channel for stream announcements**\r\n\r\n Send the \"announcechannel\" command with one argument, which should be the name of the discord\r\n channel you would like stream announcements to be sent to. e.g. \"@BotName !announcechannel channel-name\":\r\n\r\n .. image:: images/set_channel.png\r\n\r\n The stream announcement channel name is saved in the configuration file.\r\n\r\n#. **Setting custom phrases for stream announcements**\r\n\r\n This is optional, but there is only 1 default stream announcement phrase, so\r\n you might want to add some of your own. Each time a streamer goes live, one\r\n of your stream announcement phrases is picked randomly for the announcement.\r\n Phrases may contain format tokens (see the \"@BotName !help addphrase\" command\r\n for more information about format tokens). e.g. \"@BotName !addphrase some custom phrase\":\r\n\r\n .. image:: images/add_phrase.png\r\n\r\n For reference, the phrase from the previous image produces the following stream announcement\r\n when a streamer named \"OhmLab\" starts streaming on a Wednesday:\r\n\r\n .. image:: images/stream_announcement.PNG\r\n\r\n All stream announcement phrases are saved in the configuration file.\r\n\r\n#. **Setting twitch client ID and client secret**\r\n\r\n in a DM with the bot in discord, or in any public channel, send the \"twitchclientid\"\r\n command with two arguments, e.g. \"@BotName !twitchclientid xxxx yyyy\".\r\n\r\n Replace \"xxxx\" with your twitch client ID, and replace \"yyyy\" with your twitch client\r\n secret. You must have a twitch account, and register an application, to obtain a\r\n client ID and client secret for your application. `instructions here <https://dev.twitch.tv/docs/authentication/register-app>`_.\r\n\r\n .. image:: images/set_twitchclientid.png\r\n\r\n\r\n You can change the client ID and client secret at any time, using the same command.\r\n The client ID and client secret you provide with this command is saved in the config file,\r\n so there is no need to re-send this every time you start the bot.\r\n\r\nRunning nedry as a systemctl service\r\n====================================\r\n\r\nUse the `nedry.service <https://raw.githubusercontent.com/eriknyquist/nedry/master/scripts/nedry.service>`__\r\nfile available on github to quickly create a systemctl service for running nedry.\r\n\r\nNOTE: This service loads a config file at ``/home/ubuntu/nedry_config.json``, you may\r\nneed to edit the \"ExecStart\" line and change that path to your config file location.\r\n\r\nNOTE: This service loads the environment of a user named \"ubuntu\", you may need to\r\nedit the \"User\" line and change the username to your own username.\r\n\r\nWriting and using plugins\r\n=========================\r\n\r\n* In order to use plugins, you must add at least one directory path to the ``plugin_directories``\r\n list in the configuration file. Plugins are installed by placing the python file(s) directly\r\n in the top level of any directory listed in ``plugin_directories`` (not in a subdirectory!).\r\n If any valid plugins exist in any the directories listed in ``plugin_directories`` when the\r\n bot starts up, they will be loaded and available for use.\r\n\r\n* All loaded plugins are enabled by default. To see a list of all plugins, enabled and\r\n disabled, use the ``!plugins`` command. To disable/enable a plugin, use the\r\n ``!plugson`` and ``!plugsoff`` commands. For example, to disable the built-in\r\n ``knock_knock_jokes`` plugin, use ``@BotName !plugsoff knock_knock_jokes``.\r\n\r\n* To get started with writing plugins, see `this sample plugin <https://github.com/eriknyquist/nedry/blob/nedry/example_plugins/echo_dm_example.py>`_.\r\n\r\n Also, see `this more complex built-in plugin <https://github.com/eriknyquist/nedry/blob/nedry/nedry/builtin_plugins/knock_knock_jokes.py>`_\r\n\r\n\r\nMisc. sample bot interactions\r\n=============================\r\n\r\nThe following are some screenshots of miscellaneous command / response interactions\r\nwith the bot in discord. This section is *not* intended as a comprehensive reference\r\nof all available commands (see the \"Bot command reference\" section at the end for that),\r\nbut rather a quick illustration of what it looks like to interact with the bot in discord.\r\n\r\nAnnouncements for when a twitch streamer goes live\r\n--------------------------------------------------\r\n\r\n.. image:: images/stream_announcement.PNG\r\n\r\n\r\nScheduling a message in a public channel\r\n----------------------------------------\r\n\r\n.. image:: images/scheduled_message.PNG\r\n\r\nScheduling a DM reminder\r\n------------------------\r\n\r\n.. image:: images/reminder.PNG\r\n\r\nRequesting a knock-knock joke from the bot\r\n------------------------------------------\r\n\r\n.. image:: images/tell_joke.PNG\r\n\r\nTelling a knock-knock joke for the bot to remember\r\n--------------------------------------------------\r\n\r\n.. image:: images/remember_joke.PNG\r\n\r\nAsking the bot to do a wikipedia search\r\n---------------------------------------\r\n\r\n.. image:: images/wiki.png\r\n\r\nAsking the bot to make fun of the last thing someone said\r\n---------------------------------------------------------\r\n\r\n.. image:: images/mocking.PNG\r\n\r\nConfiguration file details\r\n==========================\r\n\r\nThis section covers all configuration file parameters, including those not covered\r\nin the Quick Start section. The configuration file must be a .json file of the following form:\r\n\r\n::\r\n\r\n {\r\n \"twitch_client_id\": \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\r\n \"twitch_client_secret\": \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\r\n \"discord_bot_api_token\": \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\r\n \"discord_server_id\": 123456789123456789,\r\n \"discord_channel_name\": \"my-discord-channel\",\r\n \"poll_period_seconds\": 60,\r\n \"host_streamer\": \"my-twitch-streamer-name\",\r\n \"silent_when_host_streaming\": true,\r\n \"plugin_data\": {},\r\n \"plugin_directories\" : [\"/home/user/nedry_plugins\"],\r\n \"discord_admin_users\" : [422222187366187010, 487222187346187011],\r\n \"discord_joke_tellers\" : [422222187366187010, 487222187346187011],\r\n \"jokes\": [],\r\n \"timezones\": {},\r\n \"command_log_file\" : \"/home/user/twitch_monitor_bot_command_log.txt\",\r\n \"startup_message\": \"Hello! I am a bot who can monitor twitch streams for you.\",\r\n \"streamers_to_monitor\": [\r\n \"mrsketi\",\r\n \"none_of_many\"\r\n ],\r\n \"stream_start_messages\": [\r\n \"{streamer_name} is now streaming! watch it here: {stream_url}\",\r\n \"{streamer_name} is doing something, go see it here: {stream_url}\"\r\n ]\r\n }\r\n\r\nDescription of fields\r\n---------------------\r\n\r\n* ``twitch_client_id``: Enter your Twitch client ID here.\r\n\r\n* ``discord_bot_api_token``: Enter the API token for your discord bot application here.\r\n\r\n* ``discord_server_id``: Enter the server ID for the server you want the bot to connect to here.\r\n\r\n* ``discord_channel_name``: Enter the name of the channel you want the bot to connect to here.\r\n\r\n* ``poll_period_seconds``: Enter the desired delay (in seconds) between checking if all streamers are live here.\r\n\r\n* ``host_streamer``: Enter the name of your own twitch channel here (optional).\r\n\r\n* ``silent_when_host_streaming``: If true, no announcements about other streams will be made when host streamer is live.\r\n\r\n* ``plugin_directories``: List of directory names to search for plugins to load on startup\r\n\r\n* ``plugin_data``: Holds persistent data for plugins, dict keyed by plugin name\r\n\r\n* ``discord_admin_users``: Multiple discord user ID numbers can be added here. Users added\r\n here will be allowed to configure the bot by sending commands in discord.\r\n\r\n* ``discord_joke_tellers``: Multiple discord user ID numbers can be added here. Any knock-knock\r\n jokes told to the bot by discord users in this list, will be \"remembered\" (stored in the \"jokes\"\r\n list), and can be told back to other discord users later when a joke is requested.\r\n\r\n* ``jokes``: Any jokes remembered by the bot from discord users will be stored here.\r\n\r\n* ``timezones``: Dict that maps discord user ID numbers to the IANA name of the timezone they are in.\r\n When you tell the bot your timezone with the \"timezone\" command, this is where it is stored.\r\n\r\n* ``command_log_file``: Enter desired filename to log commands received from discord messages.\r\n Set to \"null\" if you don't want to log commands.\r\n\r\n* ``startup_message``: Enter the message you would like the bot to send when it comes online after being started up here.\r\n Message may contain the following format tokens:\r\n\r\n * ``{botname}`` : replaced with bot name that is seen by other discord users\r\n * ``{date}`` : will be replaced with current date in DD/MM/YYY format\r\n * ``{times}`` : will be replaced with current time in HH:MM:SS format\r\n * ``{time}`` : will be replaced with current time in HH:MM format\r\n * ``{day}`` : will be replaced with the name of the current weekday (e.g. \"Monday\")\r\n * ``{month}`` : will be replaced with the name of the current month (e.g. \"January\")\r\n * ``{year}`` : will be replaced with the current year (e.g. \"2022\")\r\n\r\n\r\n* ``streamers_to_monitor``: Enter the list of streamer names to monitor here.\r\n\r\n* ``stream_start_messages``: Multiple messages can be defined here to be used as announcements\r\n for streamers going live. Messages may contain the following format tokens:\r\n\r\n * ``{streamer_name}`` : will be replaced with the name of the streamer\r\n * ``{stream_url}`` : will be replaced with the stream URL on twitch.com\r\n * ``{botname}`` : replaced with bot name that is seen by other discord users\r\n * ``{date}`` : will be replaced with current date in DD/MM/YYY format\r\n * ``{times}`` : will be replaced with current time in HH:MM:SS format\r\n * ``{time}`` : will be replaced with current time in HH:MM format\r\n * ``{day}`` : will be replaced with the name of the current weekday (e.g. \"Monday\")\r\n * ``{month}`` : will be replaced with the name of the current month (e.g. \"January\")\r\n * ``{year}`` : will be replaced with the current year (e.g. \"2022\")\r\n\r\nEvent reference for plugins\r\n===========================\r\n\r\nIf you are writing a plugin, you probably need to subscribe to some events (as shown\r\nin `this example plugin <https://github.com/eriknyquist/nedry/blob/master/example_plugins/echo_dm_example.py>`_).\r\nThis section enumerates al available event types in ``nedry.event_types.events``, along\r\nwith their expected arguments and a brief description:\r\n\r\n.. list-table:: nedry.event_types.EventType\r\n :widths: 30 30 30\r\n :header-rows: 1\r\n\r\n * - Event\r\n - Event arguments\r\n - Event description\r\n\r\n * - DISCORD_MESSAGE_RECEIVED\r\n - (message)\r\n\r\n \"message\" is the discord.py message object (see\r\n `discord.py docs <https://discordpy.readthedocs.io/en/stable/api.html#discord.Message>`__)\r\n - Emitted whenever any discord message is received, either in a public channel\r\n which the bot has access to, or in a DM with the bot.\r\n\r\n * - DISCORD_BOT_MENTION\r\n - (message, text_without_mention)\r\n\r\n \"message\" is the discord.py message object (see\r\n `discord.py docs <https://discordpy.readthedocs.io/en/stable/api.html#discord.Message>`__).\r\n \"text_without_mention\" is the message text with the bot mention stripped out.\r\n - Emitted whenever any discord message that starts with a mention of the bots\r\n discord name is received, either in a public channel which the bot has access\r\n to, or in a DM with the bot.\r\n\r\n * - NEW_DISCORD_MEMBER\r\n - (member)\r\n\r\n \"member\" is the discord.py User object of the member who joined\r\n (see `discord.py docs <https://discordpy.readthedocs.io/en/stable/api.html#discord.User>`__).\r\n - Emitted whenever a new user joins the discord server.\r\n\r\n * - DISCORD_CONNECTED\r\n - No arguments\r\n - Emmitted whenever the bot is connected to the configured discord server\r\n (this can take up to a few seconds after startup)\r\n\r\n * - TWITCH_STREAM_STARTED\r\n - (name, url)\r\n\r\n \"name\" is the Twitch name of the streamer who started streaming.\r\n \"url\" is the Twitch URL of the stream that started.\r\n - Emitted whenever one of the streamers configured for monitoring starts streaming.\r\n\r\n * - TWITCH_STREAM_ENDED\r\n - (name, url)\r\n\r\n \"name\" is the Twitch name of the streamer who stopped streaming.\r\n \"url\" is the Twitch URL of the stream that ended.\r\n - Emitted whenever one of the streamers configured for monitoring stops streaming.\r\n\r\n * - HOST_STREAM_STARTED\r\n - No arguments\r\n - Emitted when the configured host streamer starts streaming\r\n\r\n * - HOST_STREAM_ENDED\r\n - No arguments\r\n - Emitted when the configured host streamer stops streaming\r\n\r\nBot command reference\r\n=====================\r\n\r\nCommand ``help``\r\n----------------\r\n\r\n::\r\n\r\n\r\n help [command]\r\n\r\n Shows helpful information about the given command. Replace [command] with the\r\n command you want help with.\r\n\r\n\r\n Example:\r\n\r\n @BotName !help wiki\r\n\r\n All discord users may use this command.\r\n\r\n\r\nCommand ``quote``\r\n-----------------\r\n\r\n::\r\n\r\n\r\n quote\r\n\r\n Displays a random famous quote\r\n\r\n Example:\r\n\r\n @BotName !quote\r\n\r\n All discord users may use this command.\r\n\r\n\r\nCommand ``timezone``\r\n--------------------\r\n\r\n::\r\n\r\n\r\n timezone [timezone_name]\r\n\r\n Set the timezone for the author of the discord message, allowing this\r\n discord user to provide/see dates and times in their local timezone.\r\n\r\n [timezone_name] should be replaced with the name of a timezone from the IANA\r\n time zone database, or some substring, e.g. \"london\" or \"los angeles\". If you\r\n live in a big city, then often just typing the name of the city here will be\r\n enough. If you are having issues, however, try selecting your region on\r\n this IANA timezone map, and using the country/city name that is shown in\r\n the drop-down selection box: https://kevalbhatt.github.io/timezone-picker\r\n\r\n Sending this command with no arguments will query the timezone currently\r\n assigned to the author of the discord message.\r\n\r\n Example:\r\n\r\n @BotName !timezone # Query timezone setting for this discord user\r\n @BotName !timezone london # Set timezone for this discord user to \"Europe/London\"\r\n\r\n All discord users may use this command.\r\n\r\n\r\nCommand ``streamers``\r\n---------------------\r\n\r\n::\r\n\r\n\r\n streamers\r\n\r\n Shows a list of streamers currently being monitored.\r\n\r\n Example:\r\n\r\n @BotName !streamers\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``addstreamers``\r\n------------------------\r\n\r\n::\r\n\r\n\r\n addstreamers [name] ...\r\n\r\n Adds one or more new streamers to list of streamers being monitored. Replace\r\n [name] with the twitch name(s) of the streamer(s) you want to monitor.\r\n\r\n Example:\r\n\r\n @BotName !addstreamers streamer1 streamer2 streamer3\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``removestreamers``\r\n---------------------------\r\n\r\n::\r\n\r\n\r\n removestreamers [name] ...\r\n\r\n Removes one or more streamers from the list of streamers being monitored. Replace [name]\r\n with the twitch name(s) of the streamer(s) you want to remove.\r\n\r\n Example:\r\n\r\n @BotName !removestreamers streamer1 streamer2 streamer3\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``clearallstreamers``\r\n-----------------------------\r\n\r\n::\r\n\r\n\r\n clearallstreamers\r\n\r\n Clears the list of streamers currently being monitored.\r\n\r\n Example:\r\n\r\n @BotName !clearallstreamers\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``phrases``\r\n-------------------\r\n\r\n::\r\n\r\n\r\n phrases\r\n\r\n Shows a numbered list of phrases currently in use for stream announcements.\r\n\r\n Example:\r\n\r\n @BotName !phrases\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``testphrases``\r\n-----------------------\r\n\r\n::\r\n\r\n\r\n testphrases\r\n\r\n Shows all phrases currently in use for stream announcements, with the format tokens\r\n populated, so you can see what they will look like when posted to the discord channel.\r\n\r\n Example:\r\n\r\n @BotName !testphrases\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``addphrase``\r\n---------------------\r\n\r\n::\r\n\r\n\r\n addphrase [phrase]\r\n\r\n Adds a new phrase to be used for stream annnouncements. The following format\r\n tokens may be used within a phrase:\r\n\r\n {streamer_name} : replaced with the streamer's twitch name\r\n {stream_url} : replaced with the stream URL on twitch.tv\r\n {botname} : replaced with bot name that is seen by other discord users\r\n {date} : replaced with current date in DD/MM/YYY format\r\n {times} : replaced with current time in HH:MM:SS format\r\n {time} : replaced with current time in HH:MM format\r\n {day} : replaced with the name of the current weekday (e.g. \"Monday\")\r\n {month} : replaced with the name of the current month (e.g. \"January\")\r\n {year} : replaced with the current year (e.g. \"2022\")\r\n\r\n Example:\r\n\r\n @BotName !addphrase \"{streamer_name} is now streaming at {stream_url}!\"\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``removephrases``\r\n-------------------------\r\n\r\n::\r\n\r\n\r\n removephrases [number] [number] ...\r\n\r\n Removes one or more phrases from the list of phrases being used for stream announcements.\r\n [number] must be replaced with the number for the desired phrase, as shown in the\r\n numbered list produced by the 'phrases' command. In other words, in order to remove\r\n a phrase, you must first look at the output of the \"phrases\" command to get the\r\n number of the phrase you want to remove.\r\n\r\n Example:\r\n\r\n @BotName !removephrases 3 4 5\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``nocompetition``\r\n-------------------------\r\n\r\n::\r\n\r\n\r\n nocompetition [enabled]\r\n\r\n [enabled] must be replaced with either 'true' or 'false'. If true, then no\r\n announcements about other streams will be made while the host streamer is streaming.\r\n If false, then announcements will always be made, even if the host streamer is streaming.\r\n\r\n (To check if nocompetition is enabled, run the command with no true/false argument)\r\n\r\n Examples:\r\n\r\n @BotName !nocompetition true (enable nocompetition)\r\n @BotName !nocompetition false (enable nocompetition)\r\n @BotName !nocompetition (check current state)\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``cmdhistory``\r\n----------------------\r\n\r\n::\r\n\r\n\r\n cmdhistory [entry_count]\r\n\r\n Show the last few entries in the command log file. If no count is given then the\r\n last 25 entries are shown.\r\n\r\n Examples:\r\n\r\n @BotName !cmdhistory (show last 25 entries)\r\n @BotName !cmdhistory 5 (show last 5 entries)\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``say``\r\n---------------\r\n\r\n::\r\n\r\n\r\n say [stuff to say]\r\n\r\n Causes the bot to send a message in the announcements channel, immediately, containing\r\n whatever you type in place of [stuff to say].\r\n\r\n Example:\r\n\r\n @BotName !say Good morning\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``plugins``\r\n-------------------\r\n\r\n::\r\n\r\n\r\n plugins\r\n\r\n Show all loaded plugins, and show which ones are currently enabled\r\n\r\n Example:\r\n\r\n @BotName !help wiki\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``plugson``\r\n-------------------\r\n\r\n::\r\n\r\n\r\n plugson [plugin_name] [plugin_name] ...\r\n\r\n Enable / turn on one or more plugins by name (plugin names can be seen in the\r\n output of the 'plugins' command, surrounded by square braces e.g. \"[]\").\r\n\r\n Example:\r\n\r\n @BotName !pluginon knock_knock_jokes other_plugin\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``plugsoff``\r\n--------------------\r\n\r\n::\r\n\r\n\r\n plugsoff [plugin_name] [plugin_name] ...\r\n\r\n Disable / turn off one or more plugins by name (plugin names can be seen in the\r\n output of the 'plugins' command, surrounded by square braces e.g. \"[]\").\r\n\r\n Example:\r\n\r\n @BotName !pluginoff knock_knock_jokes other_plugin\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``pluginfo``\r\n--------------------\r\n\r\n::\r\n\r\n\r\n pluginfo [plugin_name]\r\n\r\n Query information about a loaded plugin.\r\n\r\n Example:\r\n\r\n @BotName !pluginfo knock_knock_jokes\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``twitchclientid``\r\n--------------------------\r\n\r\n::\r\n\r\n\r\n twitchclientid [client_id_string] [client_secret_string]\r\n\r\n Sets the client ID and client secret used to interact with the Twitch API.\r\n Replace [client_id_string] with the client ID string for your twitch application.\r\n Replace [client_secret_string] with the client secret string for your twitch application.\r\n\r\n Example:\r\n\r\n @BotName !help twitchclientid XXXXXXXXXXXX YYYYYYYYYYYY\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``announcechannel``\r\n---------------------------\r\n\r\n::\r\n\r\n\r\n announcechannel [discord_channel_name]\r\n\r\n Sets the discord channel where stream announcements will be posted. If no discord\r\n channel name is provided, then the name of the current stream announcements channel\r\n will be returned.\r\n\r\n Example:\r\n\r\n @BotName !announcechannel # Query current channel name\r\n @BotName !announcechannel my-channel # Set announcements channel to 'my-channel'\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``joke``\r\n----------------\r\n\r\n::\r\n\r\n\r\n joke\r\n\r\n Tells an interactive knock-knock joke.\r\n\r\n You can also *tell* knock-knock jokes to the bot, and it will remember new jokes\r\n to tell them back to you later when you send this command.\r\n\r\n Any discord users can tell jokes to the bot, but only jokes told by users listed\r\n in 'discord_joke_tellers' in the configuration file will be remembered.\r\n\r\n Example:\r\n\r\n @BotName !joke\r\n\r\n All discord users may use this command.\r\n\r\n\r\nCommand ``wiki``\r\n----------------\r\n\r\n::\r\n\r\n\r\n wiki [search text]\r\n\r\n Search the provided text using Wikipedia's public API, and return the summary text\r\n (generally the first paragraph) of the first page in the search results. If no search\r\n text is provided, then a random Wikipedia article will be selected instead.\r\n\r\n Examples:\r\n\r\n @BotName !wiki python language (Show summary of wiki page for Python programming language)\r\n @BotName !wiki (Show summary of a random wiki page)\r\n\r\n All discord users may use this command.\r\n\r\n\r\nCommand ``mock``\r\n----------------\r\n\r\n::\r\n\r\n\r\n mock [mention]\r\n\r\n Repeat the last thing said by a specific user in a \"mocking\" tone. Replace [mention]\r\n with a mention of the discord user you want to mock.\r\n\r\n Example:\r\n\r\n @BotName !mock @discord_user\r\n\r\n All discord users may use this command.\r\n\r\n\r\nCommand ``apologize``\r\n---------------------\r\n\r\n::\r\n\r\n\r\n apologize [mention]\r\n\r\n Apologize to a specific user for having mocked them. Replace [mention]\r\n with a mention of the discord user you want to apologize to.\r\n\r\n Example:\r\n\r\n @BotName !apologize @discord_user\r\n\r\n All discord users may use this command.\r\n\r\n\r\nCommand ``apologise``\r\n---------------------\r\n\r\n::\r\n\r\n\r\n apologise [mention]\r\n\r\n Apologize to a specific user for having mocked them. Replace [mention]\r\n with a mention of the discord user you want to apologize to.\r\n\r\n Example:\r\n\r\n @BotName !apologize @discord_user\r\n\r\n All discord users may use this command.\r\n\r\n\r\nCommand ``schedule``\r\n--------------------\r\n\r\n::\r\n\r\n\r\n schedule [channel_name] [message_text] in|on|at [time_description]\r\n\r\n Set up a message to be sent by the bot in a specific discord channel after a specific\r\n time delay.\r\n\r\n [channel_name] should be replaced with name of the discord channel in which you\r\n want the message to be sent.\r\n\r\n [message_text] should be replaced with whatever text you want to be sent in the discord message.\r\n\r\n [time_description] should be replaced with a description of the desired time before\r\n the message is delivered to the channel. The time can be described in one of the following ways:\r\n\r\n - An absolute delay period written in english, using digits (e.g. \"5\") instead of\r\n words (e.g. \"five\") for number values. For example: \"1 minute\", \"2 hours and 3 minutes\",\r\n \"2hrs3mins\", \"2 hours & 3 minutes\"\r\n\r\n - A specific date and time, written in one of the following formats:\r\n\r\n * DD/MM/YYYY HH:MM\r\n * YYYY/MM/DD HH:MM\r\n * HH:MM DD/MM/YYYY\r\n * HH:MM YYYY/MM/DD\r\n\r\n NOTE: if you are using a specific date/time, you should first tell the bot which\r\n timezone you are in using the \"!timezone\" command. That way, you can provide dates/times\r\n in your local timezone. You only have to set your timezone once, the bot will\r\n remember it (see \"@BotName !help timezone\" for more details about how to set your timezone).\r\n\r\n Sending the command with no arguments returns the list of currently scheduled messages.\r\n\r\n Examples:\r\n\r\n @BotName !schedule # Query currently scheduled messages\r\n @BotName !schedule jokes haha! in 2 hours # Schedule message to \"jokes\" in 2 hours\r\n @BotName !schedule news raining :( in 1h & 10m # Schedule message to \"news\" in 1 hour, 10 mins\r\n @BotName !schedule general howdy! at 17:02 23/10/2025 # Schedule message to \"general\" at specific date & time\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``unschedule``\r\n----------------------\r\n\r\n::\r\n\r\n\r\n unschedule [message_number] [message_number] ...\r\n unschedule all\r\n unschedule last\r\n\r\n Remove one or more scheduled messages by number. [message_number] should be replaced\r\n with the number of the message you want to remove, as shown by the output of running the\r\n '!schedule' command with no arguments.\r\n\r\n Alternatively, instead of passing numbers, you can pass a single argument of \"all\"\r\n to remove all scheduled messages at once, or \"last\" to remove the most recently\r\n added scheduled message.\r\n\r\n Examples:\r\n\r\n @BotName !unschedule last # Remove last added message\r\n @BotName !unschedule all # Remove all messages\r\n @BotName !unschedule 2 # Remove message #2\r\n @BotName !unschedule 5 6 # Remove messages 5 and 6\r\n\r\n Only discord users registered in 'discord_admin_users' in the bot configuration file may use this command.\r\n\r\n\r\nCommand ``remindme``\r\n--------------------\r\n\r\n::\r\n\r\n\r\n remindme [reminder_text] in|on|at [time_description]\r\n\r\n Set up a reminder. After the specified time, the bot will send you a DM with whatever\r\n text you provided for [reminder_text].\r\n\r\n [reminder_text] should be replaced with whatever text you want in the reminder message,\r\n e.g. the thing that you want to be reminded of.\r\n\r\n [time_description] should be replaced with a description of the desired time before\r\n the reminder is delivered. The time can be described in one of the following ways:\r\n\r\n - An absolute delay period written in english, using digits (e.g. \"5\") instead of\r\n words (e.g. \"five\") for number values. For example: \"1 minute\", \"2 hours and 3 minutes\",\r\n \"2hrs3mins\", \"2 hours & 3 minutes\"\r\n\r\n - A specific date and time, written in one of the following formats:\r\n\r\n * DD/MM/YYYY HH:MM\r\n * YYYY/MM/DD HH:MM\r\n * HH:MM DD/MM/YYYY\r\n * HH:MM YYYY/MM/DD\r\n\r\n NOTE: if you are using a specific date/time, you should first tell the bot which\r\n timezone you are in using the \"!timezone\" command. That way, you can provide dates/times\r\n in your local timezone. You only have to set your timezone once, the bot will\r\n remember it (see \"@BotName !help timezone\" for more details about how to set your timezone).\r\n\r\n Sending the command with no arguments returns the list of active reminders\r\n for the user that sent the command.\r\n\r\n Examples:\r\n\r\n @BotName !remindme # Query current reminders for me\r\n @BotName !remindme To take out the trash... in 12 hours # schedule reminder in 12 hours\r\n @BotName !remindme to take a shower :D in 1 day and 5 mins # Schedule reminder in 1 day and 5 minutes\r\n @BotName !remindme to brush my teeth on 22/4/2025 14:30 # Schedule reminder at specific date & time\r\n\r\n All discord users may use this command.\r\n\r\n\r\nCommand ``unremind``\r\n--------------------\r\n\r\n::\r\n\r\n\r\n unremind [reminder_number] [reminder_number] ...\r\n unremind all\r\n unremind last\r\n\r\n Remove one or more reminders by number. [reminder_number] should be replaced with the\r\n number of the reminder you want to remove, as shown by the output of running the\r\n '!remindme' command with no arguments.\r\n\r\n Alternatively, instead of passing numbers, you can pass a single argument of \"all\"\r\n to remove all reminders at once, or \"last\" to remove the last reminder that you scheduled.\r\n\r\n Examples:\r\n\r\n @BotName !unremind last # Remove last added reminder\r\n @BotName !unremind all # Remove all reminders\r\n @BotName !unremind 2 # Remove reminder #2\r\n @BotName !unremind 5 6 # Remove reminders 5 and 6\r\n\r\n All discord users may use this command.\r\n\r\n\r\nCommand ``trivia``\r\n------------------\r\n\r\n::\r\n\r\n\r\n trivia [time_limit]\r\n\r\n Fetch a trivia question from opentdb.com and allow all discord users to provide\r\n an answer until the time limit is up. Whoever provides the correct answer first\r\n gets 2 points, and any other correct answers that came after that get 1 point.\r\n If the correct answer is not provided, then no points are awarded.\r\n\r\n [time_limit] should be replaced with the desired time limit for the question, in seconds.\r\n This parameter is optional; if no time limit is provided then a time limit of 60 seconds\r\n will be used.\r\n\r\n Example:\r\n\r\n @BotName !trivia\r\n\r\n All discord users may use this command.\r\n\r\n\r\nCommand ``triviascores``\r\n------------------------\r\n\r\n::\r\n\r\n\r\n triviascores\r\n\r\n Shows total score for all discord users who have ever answered a trivia question correctly.\r\n The first correct answer to a trivia question gets 2 points, and all other correct answers\r\n get 1 point.\r\n\r\n Example:\r\n\r\n @BotName !triviascores\r\n\r\n All discord users may use this command.\r\n\r\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "A fun & useful discord bot with a modular plugin system",
"version": "2.3.2",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3a9363029eb717f2fe932f724cc6f0baec0e5a231ccb563cae32c2acbbe9eac9",
"md5": "9bf4cf500ff2f4750c9241aa04658b75",
"sha256": "06e91325b754de06f6118d5fdd817ffbec8e70733eb1111039fdc604273e858d"
},
"downloads": -1,
"filename": "nedry-2.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9bf4cf500ff2f4750c9241aa04658b75",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 53432,
"upload_time": "2023-01-30T02:13:50",
"upload_time_iso_8601": "2023-01-30T02:13:50.548310Z",
"url": "https://files.pythonhosted.org/packages/3a/93/63029eb717f2fe932f724cc6f0baec0e5a231ccb563cae32c2acbbe9eac9/nedry-2.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-01-30 02:13:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "eriknyquist",
"github_project": "nedry",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "nedry"
}
JSON
