⚠️ This library is on lifeline support and I am looking for a new maintainer. Please DM me if you are interested.
Songbird bindings for python. The goal is to provide an easy to use alternitive to Lavalink. Its written with rust-bindings to Songbird.
This library requires Opus to be installed. ffmpeg functions also require FFmpeg to be installed.
static-ffmpeg package on pypi does not work
If you are not on windows, macos, or linux x86_64 or need to use a version of python different than 3.8-3.10 you will need to build the source dist. The only change to the installation process is that Rust will need to be installed before installing from pip.
Once you are connected to a channel, playing music is extremely easy.
from songbird import ytdl
# `voice` was created from a connection to the gateway.
track_handle = await voice.play_source(await ytdl("https://www.youtube.com/watch?v=r25MAkzkTF4"))
await sleep(5)
# Doesn't need to be awaited!
track_handle.pause()
await sleep(5)
track_handle.play()Hikari and Pincer are currently the only supported libraries. See the examples directory for more information.
from asyncio import run
from songbird import Driver
async def main():
voice = await Driver.create()
# `server` is the server payload from the gateway.
# `state` is the voice state payload from the gateway.
await voice.connect(
token=server.token,
endpoint=server.endpoint,
session_id=state.session_id,
guild_id=server.guild_id,
channel_id=state.channel_id,
user_id=state.user_id
)
run(main())Pyo3 asyncio is used with tokio.
Maturin should be installed though pip. This is used to build the Rust code to a python lib.
Run command maturin develop when changes are made to the Rust src.
pyo3 asyncio docs You can also look at the async secion of the pyo3 docs.
Its a good idea to install all the dependencies.
Create API for songbird driver and everything that is needed with it it.