owntone-server/INSTALL

63 lines
2.2 KiB
Plaintext
Raw Normal View History

2009-06-12 06:15:52 -04:00
Installation instructions for forked-daapd
------------------------------------------
Required tools:
- ANTLR v3 is required to build forked-daapd, along with its C runtime
(libantlr3c). Use at least version 3.1.x of ANTLR v3 and the matching
C runtime version. Version 3.1.3 is recommended.
2009-06-12 06:15:52 -04:00
2010-01-10 05:27:19 -05:00
- Java runtime: ANTLR is written in Java and as such a JRE is required to
run the tool. The JRE is enough, you don't need a full JDK.
2009-12-20 08:35:57 -05:00
- autotools: autoconf 2.63+, automake 1.10+, libtool 2.2. Run autoreconf -i
2009-12-13 03:51:48 -05:00
at the top of the source tree to generate the build system.
- pkg-config
2009-06-12 06:15:52 -04:00
The configure script will look for a wrapper called antlr3 in the PATH to
invoke ANTLR. If it doesn't exist, it'll try to invoke ANTLR directly with
'java org.antlr.Tool'; make sure your CLASSPATH is set properly, and if it
doesn't work, just create the wrapper somewhere in your PATH.
2010-01-10 05:27:19 -05:00
System-specific libraries:
- Linux:
+ glibc 2.9+ (for signalfd)
General libraries:
2009-06-12 06:15:52 -04:00
- Avahi client libraries, 0.6.24 minimum
- sqlite3
- ffmpeg
- confuse
- libevent 1.4+
- libavl
- MiniXML
- gcrypt 1.2.0+
- libflac (optional - FLAC support)
- taglib (optional - Musepack support)
- libplist 0.16+ (optional - iTunes XML support)
2009-06-12 06:15:52 -04:00
libavl is not the GNU libavl. There doesn't seem to be an upstream website
anymore, but you can fetch it from any Debian mirror for instance (it'll be
in /debian/pool/main/liba/libavl).
FLAC and Musepack support are optional. If not enabled, metadata extraction
will fail on these files.
Support for iTunes Music Library XML format is optional. Use --enable-itunes
to enable this feature.
2009-06-12 06:15:52 -04:00
Recommended build settings:
./configure --prefix=/usr --sysconfdir=/etc --localstatedir=/var --enable-flac --enable-musepack
After installation, edit the configuration file, /etc/forked-daapd.conf and
adjust the values at your convenience.
forked-daapd will drop privileges to any user you'll specify in the
configuration file if it's started as root. It's recommended to create a
dedicated user without login privileges. That user must have read permissions
on your library.
You'll need an init script if you want to start forked-daapd at boot. A simple
init script will do, forked-daapd daemonizes all by itself and creates a
pidfile under /var/run.