1TABLE OF CONTENTS
2
31. compiling, dependencies, etc
42. licensing
5
6==========================================================
7
81. compiling, dependencies, etc
9
10* first you need to install dependencies. full list is provided at the end of this section for your convenience
11
12* you will need intltool to be installed. if you don't need translations -- run ./configure --disable-nls (in this case you won't need to install intltool, as long as the configure script is already generated)
13
14* if you want to build from git - install autoconf, automake, libtool, intltool, autopoint, then run ./autogen.sh to bootstrap
15
16* run "./configure --help", and read it.
17
18* now you're ready to configure the build process -- run "./configure --prefix=/usr", and wait until it finishes. you may want to change prefix to another value. consult INSTALL file for more info.
19
20* make sure all plugins which you want have "Yes" status in the list that's printed by configure. if not -- install missing dependencies, and rerun configure. that is especially important for GTKUI, and ALSA or OSS plugins. make sure you have both. otherwise you won't get GUI and/or sound output.
21
22* after satisfying all dependencies, run "make -j5" (change -j number to suit your number of CPUs/cores, e.g. 5 is quite good for single CPU dual-core machines). it is a good idea to do it as normal user (this step doesn't require root privileges).
23
24* after build finishes, run "make install" as root
25
26full list of dependencies is below.
27most of them are optional, which means deadbeef will build and run without them, but to make it useful - you'd probably need at least GTK UI plugin and some audio codecs built.
28
29    libsamplerate: for dsp_libsrc plugin (resampler)
30    gtk+-2.0 >= 2.12 (+ gthread, + glib): GTK+ 2.0 user interface
31    gtk+-3.0 >= 3.00 (+ gthread, + glib): GTK+ 3.0 user interface
32    jansson: mandatory for both gtk2 and gtk3 UIs, used for column configuration loading
33    alsa-lib: ALSA support
34    libvorbis and libogg: for ogg vorbis plugin, and for ogg container metadata in other formats, such as OggFlac
35    libcurl >= 7.10: for last.fm, vfs_curl (shoutcast/icecast), artwork plugins
36    imlib2: for artwork plugin; see libjpeg and libpng below
37    libjpeg and libpng: for artwork plugin (when imlib2 is not installed, or --disable-artwork-imlib2 is used)
38    libmad (optional): for mp3 plugin
39    libmpg123 (optional): for mp3 plugin
40        NOTE: the mp3 plugin has multiple backends since deadbeef 0.7, both libmad and libmpg123 are supported at the same time, and can be selected by the user from plugin configuration dialog. At least one of them is required to satify mp3 plugin dependencies. But having both is preferred.
41    libFLAC: for flac plugin
42    wavpack: for wavpack plugin
43    libsndfile: for sndfile plugin
44    libcdio + libcddb: for cd audio plugin
45    ffmpeg: for ffmpeg plugin
46    xlib: for global hotkeys and gtkui
47    dbus: for notification daemon support (OSD current song notifications)
48    pulseaudio: for PulseAudio output plugin
49    faad2: for AAC plugin
50    zlib: for Audio Overload plugin (psf, psf2, etc), GME (for vgz)
51    libzip: for vfs_zip plugin
52    yasm: required to build assembly portions of ffap plugin on supported platforms (x86, x86_64)
53
54actual package names for your Linux distribution may vary.
55
56
572. licensing
58
59DeaDBeeF core uses ZLIB license. See COPYING in each subdirectory for details.
60