disopy 2.2.0

A Discord bot for listening music from a Subsonic server.

Disopy

A Discord bot for listening music from a Subsonic server.

Setup

The only external dependencies needed are:

• ffmpeg.
• libopus.

Then just install the bot from PyPI with pipx:

pipx install disopy

Or directy with pip:

python3 -m pip install disopy

Finally generate a basic config file:

disopy --generate-config

It will be located at ${XDG_CONFIG_DIR}/disopy/config.toml (in most cases $HOME/.config/disopy/config.toml), remember to edit it with your configuration values.

Docker

There is an official Docker container with name ghcr.io/kutu-dev/disopy. An example compose file is also provided.

Running the bot

The bot needs two environment variables:

• DISOPY_SUBSONIC_PASSWORD: The password to be send to the Subsonic REST API.
• DISOPY_DISCORD_TOKEN: The token to be used when authenticating to the Discord API.

And then just start the bot!

DISOPY_SUBSONIC_PASSWORD=foo DISOPY_DISCORD_TOKEN=bar disopy

[!WARNING]
This bot needs the Message Content Intent privileged Gateway enable in the Discord Developers Application Bot settings to run correctly.

Contributing

If you are interested in fixing bugs or adding new features please check the contributing guide.

Acknowledgements

• Created with :heart: by Jorge "Kutu" Dobón Blanco.
• JmTexas19: Creator of Subrift, project forked that served as a base for Disopy.
• iGieri: Fix issue #1.
• outmaneuver: Fix issue #3.
• An May (YUR0ii): Make HTTPS optional.