A cli bot to send simple messages to a Discord channel.
Project description
A simple python Discord bot to send messages to Discord channel via command line.
It allows markdown formatted messages and attaching files.
It registers the following commands:
dbot-run - main CLI entry-point
dbot-message - (short-hand) to send a message, or even pipe - message contents
dbot-file - (short-hand) to send a file with an message
Requirements
Python >= 3.6 (see badges above) (Python 3.5.3 would technically be possible, but does not support PEP 498 f-Strings, so a large portion of the string formatting would need rewrites.)
Installation
python3 -m pip install discord-notifier-bot
Optionally, install it locally with --user.
Configuration
Configuration is done by placing a .dbot.conf file in one of the following directories:
$HOME/.dbot.conf
$HOME/dbot.conf
./.dbot.conf
./dbot.conf
/etc/dbot.conf
Alternatively a configuration file can be provided via -c/--config CLI options.
The configuration file should be a standard INI file. A template can be found in the templates folder. All configurations are placed under the discord-bot section.
Example:
[discord-bot]
# the bot token (used for login)
token = abc
# the numeric id of a channel, can be found when activating the developer options in appearances
channel = 123
Usage
dbot-message and dbot-file are simpler versions of dbot-run.
Print help and available options:
dbot-run -h
Sending messages:
# send a simple message
dbot-run message "Test message"
# or shorter:
dbot-message "Test **message**"
# pipe output
echo "Test" | dbot-emessage -
# wrap it inside a code-block ```
# optionally with a type
cat `which dbot-message` | dbot-message - --type
cat `which dbot-message` | dbot-message - --type python
Sending a file:
dbot-file README.rst "Your message to desribe the attached file"
# or with no visible message:
dbot-file README.rst ""
# optionally also like this:
dbot-run file -f README.rst "Message ..."
You are always able to specify the configuration file like this:
dbot-run -c /path/to/dbot.conf [...]
dbot-{message,file} -c /path/to/dbot.conf [...]
Only with dbot-run: To display debugging information (api calls, log messages etc.):
dbot-run -d [...]
You may also run the bot with the python module notation. But it will only run the same entry-point like dbot-run.
python -m discord_notifier_bot [...]
Full CLI help message:
usage: dbot-run [-h] [--type [TYPE]] [-f FILE] [-c CONFIG] [-d]
{message,file} message
positional arguments:
{message,file} Bot action
message Message to send
optional arguments:
-h, --help show this help message and exit
--type [TYPE] Markdown type for text messages, or default if as flag
-f FILE, --file FILE Optional file to attach to message
-c CONFIG, --config CONFIG
Config file
-d, --debug Enable debug logging
usage: dbot-file [-h] [-c CONFIG] file message
positional arguments:
file
message
optional arguments:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
Config file
usage: dbot-message [-h] [-c CONFIG] [--type [TYPE]] message
positional arguments:
message
optional arguments:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
Config file
--type [TYPE] Markdown type, or default if without value
Embedded in other scripts
Sending messages is rather straightforward. More complex examples can be found in the CLI entrypoints, see file discord_notifier_bot.cli. Below are some rather basic examples (extracted from the CLI code).
Basic setup (logging + config loading):
from discord_notifier_bot.cli import setup_logging, load_config
# logging (rather basic, if needed)
setup_logging(True)
# load configuration file (provide filename or None)
configs = load_config(filename=None)
Sending a message:
from discord_notifier_bot.bot import send_message
# message string with basic markdown support
message = "The **message** to `send`"
# bot token and channel_id (loaded from configs or hard-coded)
bot_token, channel_id = configs["token"], configs["channel"]
# send the message
send_message(bot_token, channel_id, message)
Bot Creation etc.
See information provided by:
Short description
You have to own a Discord server! Or know someone with administrator/moderation(?) privileges.
Visit and login to the Discord developer page.
Create a new application. The given name is also the visible name of the bot. (default, can be changed later?)
Create a bot (on the Bot page). You should disable the Public Bot option.
The bot login token (credentials) can be found on the Bot page.
Change to the OAuth2 page and check
Scopes: Bot
Bot Permissions: Send Messages, Attach Files (in the Text Permissions column)
Copy the URL in the Scopes section and paste it in a new browser tab.
Now you can choose one (?) of your own Discord servers to add the bot to. (For this you need server administration permissions, or be the owner..?)
To get the channel id, send the following message on your server \#channelname, or enable developer options. You may want to visit the following pages for more information:
Credits
Copyright and License Information
Copyright (c) 2020 Erik Körner. All rights reserved.
See the file “LICENSE” for information on the history of this software, terms & conditions for usage, and a DISCLAIMER OF ALL WARRANTIES.
All trademarks referenced herein are property of their respective holders.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for discord-notifier-bot-0.3.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2d6620507a722be2bb94b2bca077d663cfa24fbe2681f33304dd60f5ddc92645 |
|
MD5 | 68c7ccea8913755b78b2889b1798590f |
|
BLAKE2b-256 | 55bc1a10dc83ef86b41d1caf133cf00d3f3c031a59261626a584f058507756c3 |
Hashes for discord_notifier_bot-0.3.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c8742102da8fdc9991d268e328823afc14de9d54642f94c80f22fe1e9a1ab569 |
|
MD5 | 6c36bea7fb7a8003e779b759d51bc1fc |
|
BLAKE2b-256 | a0c44fd1a2d3e3918c39110460f521f6324f68389e1da38a74c4df5c34c53183 |