Simple Managed Audio Library - no frills library for decoding and encoding audio in pure managed .NET.
The API is well documented, and examples/tutorials can be found on the project wiki.
The goals of this project can be summarized as:
- Produce a single, managed .NET library without any native dependencies.
- Provide a simple and clear API for encoding and decoding audio streams in bulk and streaming mode.
- Provide support for loading common audio file container formats (such as
RIFFandOgg). - Aim for high performance code using modern .NET and C# features (such as
Span<T>and intrinsics).
In order to keep the implementation simple and straitforward, some limitations are introduced:
- Audio streams will not support arbitrary seeking, only forward reading.
- Minimal checks are done for file validity - it is assumed that files are well structured and standard compliant.
- Metadata (artist, title, ect...) is not loaded, and will not be written by encoders. This is planned for a future version.
Support matrix for audio encoding formats:
| Format | Encoding | Decode | Encode |
|---|---|---|---|
| Wave/RAW | LPCM (16-bit) | v0.1 | v0.1 |
| IeeeFloat (32-bit) | v0.1 | v0.1 | |
| A-Law | Future | - | |
| Mu-Law | Future | - | |
| Vorbis | Vorbis | Future | Future |
| FLAC | FLAC | Future | Future |
| Opus | Opus | Future | Future |
| RLAD | Lossless | v0.1 | v0.1 |
| Lossy | v0.1 | v0.1 |
Support matrix for container file formats:
| Format | Encoding | Decode | Encode |
|---|---|---|---|
| RIFF | Wave/RAW | v0.1 | Future |
| Ogg | Vorbis, FLAC, Opus | Future | Future |
| RLAD | RLAD | v0.1 | Future |
This is the core set of planned formats. Pull requests are encouraged to add support for more formats, or to help implement or augment existing formats. Only formats that are unencumbered by restrictive licenses and patents will be accepted.
In addition to audio decoders and encoders, SMAL provides a few other utility and nice-to-have features:
- Generators - Types are provided to generate sine, triangular, and saw-tooth tones, as well as tone combinations.
- Converters - Conversion between different PCM sample types using fast hardware instructions.
- Mux/Demux - Ability to interleave and de-interleave samples.