Crate songbird

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 "gateway" and "[serenity/twilight]" plus "[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 ConnectionInfo using any other gateway, or language for your bot, then you can run the songbird voice driver.
• Voice receive and RT(C)P packet handling via the "receive" feature.
• SIMD-accelerated JSON decoding via the "simd-json" feature.
• And, by default, a fully featured voice system featuring events, queues, seeking on compatible streams, shared multithreaded audio stream caches, and direct Opus data passthrough from DCA files.

Intents

Songbird’s gateway functionality requires you to specify the GUILD_VOICE_STATES intent.

Examples

Full examples showing various types of functionality and integrations can be found in this crate’s examples directory.

Codec support

Songbird supports all codecs and formats provided by Symphonia (pure-Rust), with Opus support provided by audiopus (an FFI wrapper for libopus).

By default, Songbird will not request any codecs from Symphonia. To change this, in your own project you will need to depend on Symphonia as well.

# Including songbird alone gives you support for Opus via the DCA file format.
[dependencies.songbird]
version = "0.4"
features = ["builtin-queue"]

# To get additional codecs, you *must* add Symphonia yourself.
# This includes the default formats (MKV/WebM, Ogg, Wave) and codecs (FLAC, PCM, Vorbis)...
[dependencies.symphonia]
version = "0.5"
features = ["aac", "mp3", "isomp4", "alac"] # ...as well as any extras you need!

Attribution

Songbird’s logo is based upon the copyright-free image “Black-Capped Chickadee” by George Gorgas White.

Re-exports

• pub use crate::driver::Driver;
• pub use crate::events::CoreEvent;
• pub use crate::events::Event;
• pub use crate::events::EventContext;
• pub use crate::events::EventHandler;
• pub use crate::events::TrackEvent;
• pub use discortp as packet;
• pub use serenity_voice_model as model;
• pub use typemap_rev as typemap;
• pub use crate::serenity::*;

Modules

• constants
  Constants affecting driver function and API handling.
• driver
  Runner for a voice connection.
• error
  Driver and gateway error handling.
• events
  Events relating to tracks, timing, and other callers.
• id
  Newtypes around Discord IDs for library cross-compatibility.
• input
  Raw audio input data streams and sources.
• join
  Future types for gateway interactions.
• serenity
  Compatibility and convenience methods for working with serenity. Requires the "serenity" feature.
• shards
  Handlers for sending packets over sharded connections.
• tracks
  Live, controllable audio instances.

Structs

• Call
  The Call handler is responsible for a single voice connection, acting as a clean API above the inner state and gateway message management.
• Config
  Configuration for drivers and calls.
• ConnectionInfo
  Parameters and information needed to start communicating with Discord’s voice servers, either with the Songbird driver, lavalink, or other system.
• Iter
  An iterator over all Calls currently stored in the manager instance.
• Songbird
  A shard-aware struct responsible for managing Calls.