Skip to main content

A Discord bot for listening music from a Subsonic server.

Project description

Disopy

justforfunnoreally.dev badge PyPI - Version PyPI - Python Version

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

Contributing

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

Acknowledgements

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

disopy-2.0.0.tar.gz (19.6 kB view details)

Uploaded Source

Built Distribution

disopy-2.0.0-py3-none-any.whl (22.5 kB view details)

Uploaded Python 3

File details

Details for the file disopy-2.0.0.tar.gz.

File metadata

  • Download URL: disopy-2.0.0.tar.gz
  • Upload date:
  • Size: 19.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for disopy-2.0.0.tar.gz
Algorithm Hash digest
SHA256 e228e996c40a76cadd693f0a3328f1761e1c534699e7cb7a436ef097c94d1ca7
MD5 9b3c11b947ec6f6416363e3b6de4b2b0
BLAKE2b-256 292dbe70b2cf86957d9e4078fc5a8277085a7be2e0df78a65be655e268ce25a9

See more details on using hashes here.

Provenance

The following attestation bundles were made for disopy-2.0.0.tar.gz:

Publisher: publish.yml on kutu-dev/disopy

Attestations:

File details

Details for the file disopy-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: disopy-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 22.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for disopy-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ff7534af38d3d6ed012c534c8ae12cf48dc0b55b02e0fce3e46fa78491b69097
MD5 3c2cfb309f077c96477be351ba891f5f
BLAKE2b-256 4e675cb8a486646f69d125d8524995eae26ed1169c4729a574f50d8b963bc9cd

See more details on using hashes here.

Provenance

The following attestation bundles were made for disopy-2.0.0-py3-none-any.whl:

Publisher: publish.yml on kutu-dev/disopy

Attestations:

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page