audio-formats

Streaming decoding support for popular audio formats.


Keywords
library, audio-formats, flac, mod, mp3, ogg, opus, qoa, wav, xm
License
BSL-1.0
Install
dub fetch audio-formats --version 3.0.2

Documentation

audio-formats

audio-formats is meant to be the easiest package to load and write sounds in D.

Features

  • ✅ Decode from WAV / QOA / MP3 / FLAC / OPUS / OGG / MOD / XM
  • ✅ Encode to WAV / QOA
  • ✅ File and memory support
  • ✅ Seeking support
  • ✅ Chunked support
  • float and double support
  • ✅ Encoding with dithering when reducing bit-depth
  • nothrow @nogc API
  • ✅ Archs: x86 / x86_64 / arm64

Changelog

🔔 audio-formats v3

  • Complete removal of exceptions. The API is now 100% nothrow @nogc. AudioFormatsException doesn't exist anymore.
  • BREAKING Instead, use .isError and .isValid to check for errors.

🔔 audio-formats v2

  • Doesn't depend upon dplug:core anymore.
  • All exceptions thrown by audio-formats are now AudioFormatsException.
    They must be clean-up with destroyAudioFormatException.
  • v2.1 QOA format decoding support (https://github.com/phoboslab/qoa). Note that the QOA bitstream isn't finalized, and will change.
  • v2.2 QOA format encoding support.

🔔 audio-formats v1

  • Initial release.

How to use it?

  • Add audio-formats as dependency to your dub.json or dub.sdl.
  • See the transcode example for usage.

What formats are supported exactly?

Decoding Encoding Seeking support
📀 WAV Yes Yes Sample
📀 MP3 Yes No Sample
📀 FLAC Yes No Sample
📀 OPUS Yes (LGPL) No Sample
📀 OGG Yes No Sample
📀 QOA Yes Yes Sample
📀 MOD Yes No Pattern+Row
📀 XM Yes No Pattern+Row

Some of these decoders were originally translated by Ketmar, who did the heavy-lifting.

License

  • ⚖️ Boost license otherwise.
  • ⚖️ MIT license when including QOA.
  • ⚖️ LGPL v2.1 for OPUS. (use DUB subconfigurations) to choose, default is boost.

External links and references

Ultra secret options

-The following version identifiers can be used to enable/disable decoder level features

Version Identifier Feature
AF_LINEAR Use linear sampling for MOD modules instead of Amiga sampling

Bugs

  • framesRemainingInPattern is unimplemented for XM currently.