Merge pull request #851 from aschey/feat/registry

feat: opus support via libopus and allow registering additional codecs

Author: yara-blue

.github/workflows/ci.yml

@@ -18,7 +18,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [macos-latest, windows-latest, ubuntu-latest]
-        toolchain: ["1.87"]
+        toolchain: ["1.89"]
         include:
           - os: macos-latest
             MACOS: true

CHANGELOG.md

@@ -19,6 +19,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Audio output fallback picked null device leading to no output.
 - Mixer did not actually add sources sometimes.
 
+### Added
+
+- Added Opus support via `symphonia-adapter-libopus`.
+- Third-party Symphonia codecs can be registered with `DecoderBuilder::with_symphonia_decoder`.
+
 ## Version [0.22.1] (2026-02-22)
 
 ### Fixed

Cargo.lock

@@ -8,7 +8,7 @@ repository = "https://github.com/RustAudio/rodio"
 documentation = "https://docs.rs/rodio"
 exclude = ["assets/**", "tests/**"]
 edition = "2021"
-rust-version = "1.87"
+rust-version = "1.89"
 
 [features]
 # Default feature set provides audio playback and common format support
@@ -50,6 +50,11 @@ noise = ["rand", "rand_distr"]
 # Enable WebAssembly support for web browsers
 wasm-bindgen = ["cpal/wasm-bindgen"]
 
+# Base symphonia feature (doesn't enable any codecs)
+# A feature with this name is created implicitly due to other features that reference `symphonia/xxx`
+# but we need to make it explicit here so other features can reference it.
+symphonia = ["dep:symphonia"]
+
 # To decode an audio source with Rodio, you need to enable the appropriate features for *both* the
 # demuxer and the decoder.
 #
@@ -96,6 +101,9 @@ symphonia-wav = ["symphonia/wav"]
 # Enable SIMD optimisations for Symphonia
 symphonia-simd = ["symphonia/opt-simd"]
 
+# libopus adapter for Symphonia
+symphonia-libopus = ["symphonia", "dep:symphonia-adapter-libopus"]
+
 # Alternative decoders and demuxers
 claxon = ["dep:claxon"]         # FLAC
 hound = ["dep:hound"]           # WAV
@@ -126,13 +134,16 @@ atomic_float = { version = "1.1.0", optional = true }
 rtrb = { version = "0.3.2", optional = true }
 num-rational = "0.4.2"
 
+symphonia-adapter-libopus = { version = "0.2", optional = true }
+
 [dev-dependencies]
 quickcheck = "1"
 rstest = "0.26"
 rstest_reuse = "0.7"
 approx = "0.5.1"
 divan = "0.1.14"
 inquire = "0.9.3"
+symphonia-adapter-fdk-aac = "0.1"
 
 [[bench]]
 name = "effects"
@@ -230,6 +241,10 @@ required-features = ["playback", "vorbis"]
 name = "music_wav"
 required-features = ["playback", "wav"]
 
+[[example]]
+name = "music_opus"
+required-features = ["playback", "symphonia-libopus"]
+
 [[example]]
 name = "noise_generator"
 required-features = ["playback", "noise"]
@@ -253,3 +268,7 @@ required-features = ["playback", "vorbis"]
 [[example]]
 name = "stereo"
 required-features = ["playback", "vorbis"]
+
+[[example]]
+name = "third_party_codec"
+required-features = ["playback", "symphonia", "symphonia-isomp4"]

Cargo.toml

@@ -0,0 +1,13 @@
+use std::error::Error;
+
+fn main() -> Result<(), Box<dyn Error>> {
+    let stream_handle = rodio::DeviceSinkBuilder::open_default_sink()?;
+    let player = rodio::Player::connect_new(stream_handle.mixer());
+
+    let file = std::fs::File::open("assets/music.opus")?;
+    player.append(rodio::Decoder::try_from(file)?);
+
+    player.sleep_until_end();
+
+    Ok(())
+}

assets/music.opus

@@ -0,0 +1,23 @@
+use rodio::decoder::DecoderBuilder;
+use std::error::Error;
+use symphonia_adapter_fdk_aac::AacDecoder;
+
+fn main() -> Result<(), Box<dyn Error>> {
+    let stream_handle = rodio::DeviceSinkBuilder::open_default_sink()?;
+    let sink = rodio::Player::connect_new(stream_handle.mixer());
+
+    let file = std::fs::File::open("assets/music.m4a")?;
+    let len = file.metadata()?.len();
+    let decoder = DecoderBuilder::new()
+        .with_data(file)
+        // Note: the length must be known for Symphonia to properly detect the format for this file
+        // This limitation will be removed in Symphonia 0.6
+        .with_byte_len(len)
+        .with_symphonia_decoder::<AacDecoder>()
+        .build()?;
+    sink.append(decoder);
+
+    sink.sleep_until_end();
+
+    Ok(())
+}

examples/music_opus.rs

@@ -8,7 +8,7 @@
     inputs: inputs.utils.lib.eachDefaultSystem (
       system: let
         pkgs = inputs.nixpkgs.legacyPackages.${system}.extend inputs.rust-overlay.overlays.default;
-        rust = pkgs.rust-bin.stable."1.87.0".default.override {
+        rust = pkgs.rust-bin.stable."1.89.0".default.override {
           extensions = [ "rust-src" "rust-analyzer" ];
         };
       in {