Red Star Bot
A configurable, extensible Discord bot with administration and entertainment plugins included. Now with added shouting.
Features
- Flexible music playing with youtube-dl, including queues, playlist support, vote-skipping, and more,
- Powerful custom commands based on our own Lisp dialect, RSLisp,
- Event logging, including message edits, deletions, and pins, user joins/leaves, and more,
- Powerful message purging by content (regex supported), author, and more,
- Message of the Day plugins with configurable holidays and messages based on day, weekday, or month,
- Voting plugin for making, responding to, and counting the results of polls,
- Reminder plugin with times, delays, and recurring reminders,
- New member announcer with easily configurable messages,
- Easy role administration for mobile users via commands,
- And more. See our wiki for more features.
Installation
With pip
Simply run pip install red-star, and Red Star and all its dependencies will be automatically installed.
You can then run Red Star by simply running python -m red_star or red_star (if Scripts is in your PATH).
From source
Installing
Running pip install -e . inside the Red Star folder will install Red Star and all its dependencies automatically.
This will allow you to run Red Star in the same way as above.
Running portably
Alternatively, one can run Red Star portably by simply navigating to the source directory and running python red_star.py -p.
This will tell Red Star to keep its loose files inside the source directory, instead of placing them in your user folder.
Usage
Starting the bot is already covered above; simply invoke red_star, python -m red_star, or python red_star.py to run the bot.
On first run, a default configuration file will be copied to ~/.red_star (C:\Users\username\.red_star on Windows) that must be edited before use.
Command-line Arguments
-[-p]ortable: Tells the bot to run in portable mode, keeping all of its loose files in its source directory. Useful if you don't want to clutter your user folder, or install the bot withpip.-[-d]irectory: Allows the user to specify a custom directory to place loose files. Cannot be used with-p.-[-l]ogfile: Allows the user to specify a different name for the log file than the default.-[-v]erbose: Tells the bot to output debug information while running. Can be called up to three times, increasing verbosity each time.
Documentation
See our wiki for additional documentation, including Command Reference, Configuring Red Star, and Adding A Bot to a Server.
1 maintainer
Metadata
1 maintainer
Release files for red-star 3.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| red_star-3.0.3.tar.gz | 91.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| red_star-3.0.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 196.6 kB
Release files / red_star-3.0.3.tar.gz
| Download URL | red_star-3.0.3.tar.gz |
|---|---|
| Size | 91.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
32f0e27582c990ccf205333bb5ea580b2afa94a097b6f0400081fca6a545a6e3
|
|
BLAKE2b-256 checksum How to use checksums |
d2d59d69a0bb3928be645de31b4d2e76ecef7210957a89c877cd0a54330042bf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / red_star-3.0.3-py3-none-any.whl
| Download URL | red_star-3.0.3-py3-none-any.whl |
|---|---|
| Size | 105.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
afc544a02d9c73ff35965d790470b62383bf74012e2b9f4921ce865fb8cb50f4
|
|
BLAKE2b-256 checksum How to use checksums |
2fb01fa92db474449b76ecb4b1dc09a614459eeba3c06feb4ace611080f4f305
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Security for red-star 3.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
