This library provides decoding and encoding of audio on a playlist. It is intended to be used as a backend for music player applications. That said, it is also generic enough to be used as a backend for any streaming audio processing utility.
- Uses ffmpeg for robust decoding and encoding. A list of supported file formats and codecs is available.
- Add and remove entries on a playlist for gapless playback.
- Supports idempotent pause, play, and seek.
- Per-playlist-item gain adjustment so you can implement loudness compensation without audio glitches.
- Read and write metadata tags.
- Choose between smooth mode and exact mode during playback.
- smooth mode - open the audio device once and resample everything to fit that sample rate and format.
- exact mode - open and close the audio device as necessary in effort to open the audio device with parameters matching the incoming audio data.
- Extensible sink-based interface. A sink provides resampling and keeps its
buffer full. Types of sinks:
- raw sink - Provides reference-counted raw audio buffers you can do whatever you like with. For example a real-time audio visualization. All other sink types are built on top of this one.
- player sink - Sends frames to a sound device.
- encoder sink - Provides encoded audio buffers. For example, you could use this to create an HTTP audio stream.
- loudness scanner sink - Uses the EBU R 128 standard to detect loudness. The values it produces are compatible with the ReplayGain specification.
- fingerprint sink - Uses chromaprint to generate unique song IDs that can be used with the acoustid service.
- Thread-safe.
- Example programs included:
playlist
- Play a series of songs with gapless playback.metadata
- Read or update song metadata.replaygain
- Report the suggested replaygain for a set of files.transcode
- Transcode one or more files into one output file.fingerprint
- Generate acoustid fingerprints for one or more files.metadata_checksum
- Read or update song metadata. This program scans the audio of the file before the metadata change, changes the metadata in a temporary file, scans the audio of the temporary file to make sure it matches the original, and then atomically renames the temporary file over the original file.
You will need these to compile libgroove.
- cmake
- ffmpeg
- suggested flags:
--enable-shared --disable-static --enable-libmp3lame --enable-libvorbis --enable-gpl
- suggested flags:
- libebur128
- make sure it is compiled with the speex dependency so that true peak functions are available.
- libsdl2-dev
- libchromaprint-dev
Installing from a package is recommended, but instructions for installing from source are also provided at the end of this list.
Note: as of Ubuntu 14.10 Utopic Unicorn, libgroove is included in the default repository index so you don't need a PPA.
sudo apt-add-repository ppa:andrewrk/libgroove
sudo apt-get update
sudo apt-get install libgroove-dev libgrooveplayer-dev libgrooveloudness-dev \
libgroovefingerprinter-dev
pkg install audio/libgroove
libgroove ships with Debian Jessie.
sudo apt-get install libgroove-dev libgrooveplayer-dev \
libgrooveloudness-dev libgroovefingerprinter-dev
libgroove is available through the AUR.
wget https://aur.archlinux.org/packages/li/libgroove/libgroove.tar.gz
tar xzf libgroove.tar.gz
cd libgroove
makepkg
sudo pacman -U libgroove-*
Some notes:
- libgroove depends upon several other packages. Dependencies available through
the official repositories can be installed with pacman (e.g.
pacman -S --asdeps sdl2
), and dependencies available through the AUR can be installed via the procedure shown above. - An AUR helper can ease the process of installing packages from the AUR.
- The AUR User Guidelines page on the Arch Wiki contains gobs of useful information. Please see that page if you have any further questions about using the AUR.
brew install libgroove
mkdir build && cd build && cmake ../
# Verify that the configure output is to your liking.
make
sudo make install
Check out the example programs in the example folder.
Read header files for the relevant APIs:
- groove/groove.h
- globals
- GrooveFile
- GroovePlaylist
- GrooveBuffer
- GrooveSink
- groove/encoder.h
- GrooveEncoder
- grooveplayer/player.h
- GroovePlayer
- grooveloudness/loudness.h
- GrooveLoudnessDetector
- groovefingerprinter/fingerprinter.h
- GrooveFingerprinter
Join #libgroove on irc.freenode.org and ask questions.
Feel free to make a pull request adding yours to this list.
- Groove Basin is a music player with lazy multi-core replaygain scanning, a web interface inspired by Amarok 1.4, http streaming, upload, download and a dynamic playlist mode.
- waveform generates PNG waveform visualizations.
- node-groove provides Node.js bindings to libgroove.
- groove-rs provides rust bindings to libgroove.
- ruby-groove provides Ruby FFI bindings to libgroove.
- TrenchBowl is a simple Qt GUI on top of libgroove.