Siren

Siren is a D&D Bot built for Discord, written in Rust. Features include:

• Play tracks from Youtube or locally hosted files
• Assistant DM tools to be defined later

Running

Visit the Discord Developer Portal and create a new application. Click here for guides and more information.

Required Scopes:

• bot
• application.commands

Example Invite:

https://discord.com/api/oauth2/authorize?client_id=<CLIENT_ID>&permissions=40671259392832&scope=bot%20applications.commands

The CLIENT_ID can be found in the General Information tab on the Discord Developer Portal for your application, under Application ID

1. Copy .env.TEMPLATE to .env and fill out the fields
2. Build the Docker application with make build
3. Start the application with make up

Contributing

Rust must be installed to run locally. See serenity-rs/serenity for more information about Rust Discord API Library.

The following packages must be installed for serenity-rs/songbird. View the repository for additional installation and setup information on other operating systems.

Unix Installation

sudo apt install libopus-dev
sudo apt install ffmpeg
sudo apt apt install youtube-dl
# PostgreSQL Headers
sudo apt install libpq5
sudo apt install libpq-dev

• Potentially requires yt-dlp and yt-dlp FFmpeg Static Auto-Builds.

Mac Installation

brew install opus
brew install ffmpeg
brew install youtube-dl
brew install postgresql

Begin the application with cargo run (note the database must still be running)

• docker compose up -d db

The application can also be tested from within a Docker container:

docker build -t siren:latest .
docker run --env-file .env -it --rm --name siren siren:latest