discord-notifier-bot 0.1.6

A cli Discord bot to send simple messages to a discord channel.

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

• discord.py

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 less complex 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 -v [...]

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 [...]

Bot Creation etc.

See information provided by:

• https://github.com/Chikachi/DiscordIntegration/wiki/How-to-get-a-token-and-channel-ID-for-Discord

• https://discordapp.com/developers/applications/

Credits

• easy-telegram-cli

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.