Songbird is an async, cross-library compatible voice system for Discord, written in Rust. The library offers:
- A standalone gateway frontend compatible with serenity and twilight using the
"[serenity/twilight]-[rustls/native]"features. You can even run driverless, to help manage your lavalink sessions.
- A standalone driver for voice calls, via the
"driver"feature. If you can create a
ConnectionInfousing any other gateway, or language for your bot, then you can run the songbird voice driver.
- And, by default, a fully featured voice system featuring events, queues, RT(C)P packet handling, seeking on compatible streams, shared multithreaded audio stream caches, and direct Opus data passthrough from DCA files.
Songbird’s gateway functionality requires you to specify the
Full examples showing various types of functionality and integrations can be found in this crate’s examples directory.
Songbird’s logo is based upon the copyright-free image “Black-Capped Chickadee” by George Gorgas White.
Constants affecting driver function and API handling.
Runner for a voice connection.
Driver and gateway error handling.
Events relating to tracks, timing, and other callers.
Newtypes around Discord IDs for library cross-compatibility.
Raw audio input data streams and sources.
Compatability and convenience methods for working with serenity.
Handlers for sending packets over sharded connections.
Live, controllable audio instances.
The Call handler is responsible for a single voice connection, acting as a clean API above the inner state and gateway message management.
Parameters and information needed to start communicating with Discord’s voice servers, either with the Songbird driver, lavalink, or other system.
A shard-aware struct responsible for managing
Voice core events occur on receipt of voice packets and telemetry.
Information about which tracks or data fired an event.
Track events correspond to certain actions or changes of state, such as a track finishing, looping, or being manually stopped. Voice core events occur on receipt of voice packets and telemetry.
Opens an audio file through
Creates a streamed audio source with