path: root/INSTALL
diff options
authorLars-Dominik Braun <>2014-03-31 17:35:28 +0200
committerLars-Dominik Braun <>2014-03-31 20:20:22 +0200
commitc872f00508ce4afe3b8ec863b23595c31fd8b4be (patch)
treec441d537a5ead0d659bb05e83e8b4bd7d4066f87 /INSTALL
parent8e685c992516834e35bcccea1f61c39a9d847e2f (diff)
Use libav/ffmpeg for audio decoding
libav 9.12 and ffmpeg 2.2 have been tested. Here’s why: My mp4 “parser” *cough* never was a mp4 parser in the sense that it actually understood the file format. Instead it grepped the input stream for “magic” strings (section identifiers). That alone should be sufficient to throw away the code and rewrite it. Additionally libfaad2 has not been updated for ages. I guess it was abandoned in favor of libav/ffmpeg. With libav/ffmpeg, which we support both as long as the API’s don’t diverge too much, pianobar gains fast and reliable AAC and MP3 decoding without bothering too much about the details. Most users will have it installed already. On my own machine libav consumes about 2/3 CPU time compared to the previous solution when playing AAC. Unfortunately memory usage doubled and my attempts to disable unused protocols/formats/codec failed due to libav’s API limitations. While cleaning up a small detail regarding the eventcmd API has changed too: Song duration and position are measured in seconds instead of milliseconds now. Since libav/ffmpeg keeps track of accurate timing the precision pianobar keeps track of can be reduced, while still being sufficient for most users.
Diffstat (limited to 'INSTALL')
1 files changed, 1 insertions, 35 deletions
diff --git a/INSTALL b/INSTALL
index 3283027..f3db418 100644
@@ -10,8 +10,7 @@ Dependencies
- gnutls
- gcrypt (with blowfish cipher enabled)
- json-c
-- libfaad2 (compiled with --without-drm)
-- libmad (optional, Pandora One users only)
+- libav/ffmpeg
- UTF-8 console/locale
@@ -29,36 +28,3 @@ Or install it by issuing
gmake install
-Selecting features
-It is possible to disable certain features when building pianobar by setting
-one of the variables listed below. In fact it is required if you don’t have the
-corresponding library installed. So if you don’t want AAC playback or don’t
-have libfaad installed for example, run
- gmake DISABLE_FAAD=1
-instead of a plain `gmake`.
- Disables AAC playback.
- Disables MP3 playback.
-Ubuntu 12.04
-To install on Ubuntu >= 12.04
- sudo apt-get install \
- libao-dev \
- libmad0-dev \
- libfaad-dev \
- libgnutls-dev \
- libjson0-dev \
- libgcrypt11-dev
- make
- sudo make install
-You can then fire it up with `pianobar`