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 / FLAC
• ✅ 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.
• v3.1 FLAC format encoding support.

🔔 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?

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 decoding and FLAC encoding. (use DUB subconfigurations) to choose, default is boost.

External links and references

• https://github.com/Zoadian/mp3decoder
• https://github.com/rombankzero/pocketmod
• https://github.com/Artefact2/libxm

Ultra secret options

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

Bugs

• framesRemainingInPattern is unimplemented for XM currently.