Symphonia
A pure Rust library for demuxing media formats, reading metadata tags, and decoding audio codecs.
What is Symphonia?
Symphonia is a pure Rust audio decoding and media demuxing library designed for multimedia applications. It provides a unified API to handle a wide range of audio formats and codecs, enabling developers to build robust audio processing tools without relying on external C libraries.
Rust developers building multimedia applications, audio processing tools, or media players that require safe, performant, and dependency-light audio decoding and demuxing.
Developers choose Symphonia for its combination of 100% safe Rust, minimal dependencies, performance comparable to C-based implementations like FFmpeg, and a consistent API that supports a wide variety of audio formats and codecs through modular feature flags.
Overview
Pure Rust multimedia format demuxing, tag reading, and audio decoding library
Use Cases
Best For
- Building audio players or media applications in Rust that require support for multiple formats like MP3, FLAC, AAC, and Vorbis.
- Developing audio processing tools that need gapless playback support for formats like FLAC, MP3, Vorbis, and WAV.
- Creating multimedia applications that require reading metadata and tags from formats such as ID3v2, APE, and Vorbis comments.
- Implementing audio decoding in safety-critical or security-conscious environments where using 100% safe Rust is a priority.
- Projects needing SIMD-optimized audio decoding (SSE, AVX, Neon) without linking to external C libraries.
- Applications that require automatic detection of media formats and selection of the appropriate decoder.
Not Ideal For
- Projects requiring audio encoding or full media pipelines with video support
- Applications that need immediate support for all audio codecs like HE-AAC or Opus
- Teams working primarily in C/C++ or other non-Rust ecosystems without Rust integration
- Real-time streaming applications with ultra-low latency demands beyond decoding
Pros & Cons
Pros
Written in 100% safe Rust, eliminating memory safety issues and providing security benefits, as emphasized in the README's focus on correctness and safety.
Has minimal external dependencies, reducing bloat and potential conflicts, which is highlighted in the features list for lightweight integration.
Includes SIMD optimizations (SSE, AVX, Neon) by default and aims for performance comparable to FFmpeg, with benchmarks showing +/-15% variance.
Supports a broad range of audio formats and codecs like MP3, FLAC, AAC, and Vorbis, with automatic detection for ease of use, as detailed in the status tables.
Cons
Some codecs like HE-AAC and Opus are listed as not started or in progress, meaning they are unavailable for production use, limiting coverage for certain audio types.
Requires managing feature flags to enable specific formats or codecs, which can be cumbersome and error-prone, especially for new users navigating the modular crate system.
Only handles audio decoding and demuxing; no support for encoding, video processing, or advanced multimedia tasks, necessitating additional libraries for full media pipelines.
Open Source Alternative To
Symphonia is an open-source alternative to the following products:
Frequently Asked Questions
Related Projects
cpalLow-level cross-platform audio I/O library in Rust
rodioRust audio playback library
rust-music-theoryA music theory guide written in Rust.
rust-portaudioPortAudio bindings and wrappers for Rust.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.