README.md

Capo Lite

Minmalist C++20 audio library

Features

• Audio source 3D positioning
• Audio clip playback (direct)
• Streaming playback with accurate and near-instant seeking
• RAII types
• Exception-less implementation
• Error callback (optional)
• Lightweight and more optimized rendition of capo
• Zero public dependencies (except standard library)

Showcase

App: player (capo-lite example)

Note: GUI powered by gvdi

Requirements

• C++20 compiler (and standard library)
• CMake 3.18+

Supported Formats

• WAV
• FLAC
• MP3

Usage

#include <capo/capo.hpp>

void capo_test() {
  auto device = capo::Device{}; // Device must outlive all sources created from it
  auto [sound_pcm, _] = capo::Pcm::from_file("audio_clip.wav"); // load / decompress audio file into Pcm
  auto sound_source = device.make_sound_source(); // make a new Sound Source instance
  sound_source.set_clip(sound_pcm.clip()); // set clip on Sound Source
  sound_source.play(); // play sound
  while (sound_source.state() == capo::State::ePlaying) {
    std::this_thread::yield(); // wait until playback complete
  }
  auto [music_pcm, compression] = capo::Pcm::make(load_file_as_bytes("music_file.mp3")); // load / decompress audio data into Pcm
  auto stream_source = device.make_stream_source(); // make a new Stream Source instance
  stream_source.set_stream(music_pcm.clip()); // set clip on Stream Source; source Pcm must outlive stream!
  stream_source.play(); // start playback
  while (stream_source.state() == capo::State::ePlaying) {
    std::this_thread::yield(); // wait until playback complete
  }
}

sound and music demonstrate basic sound and music usage, player demonstrates a scrappy Dear ImGui based music player.

Dependencies

• OpenAL Soft
• dr_libs

Misc

Original repository

LICENCE