Build dependencies:
Name Tested Notes
- libdb 4.3.21 4.2 and earlier won't work
- libgc 6.3
- libvorbisfile 1.0.1
- libpcre 4.5 need UTF-8 support
+ libdb 4.3.29 4.2 and earlier won't work
+ libgc 6.8
+ libvorbisfile 1.1.2
+ libpcre 6.7 need UTF-8 support
libmad 0.15.1b
- libgcrypt 1.2.0
+ libgcrypt 1.2.3
libao 0.8.6
- libasound 1.0.8
- Python 2.3 (optional)
- GNU C 3.3, 3.4
+ libasound 1.0.13
+ libFLAC 1.1.2
+ GNU C 4.1.2
+ GNU Make 3.81
+ Python 2.4.4 (optional)
+ GTK+ 2.8.20 (if you want the GTK+ client)
+ GLIB 2.12.4 (if you want the GTK+ client)
"Tested" means I've built against that version; earlier or later versions will
often work too.
Runtime dependencies:
- * Players:
- + ogg123 and mpg321 work for me, but you could potentially use others.
* Web server:
+ Apache 1.3.x works for me, but anything that supports CGI and
authentication should be suitable.
+ * Separate player programs are no longer required (but may still be used)
Development dependencies (only developers will need these):
- Automake 1.9.4 AM_PATH_PYTHON not good enough in 1.7
- Autoconf 2.59
- Libtool 1.5.6 1.4 not good enough
+ Automake 1.10 AM_PATH_PYTHON not good enough in 1.7
+ Autoconf 2.61
+ Libtool 1.5.22 1.4 not good enough
Bazaar (bzr)
On Debian you might ensure you have the required packages as follows:
apt-get install gcc libc-dev automake autoconf libtool libgtk2.0-dev \
libgc-dev libgcrypt-dev libpcre3-dev libvorbis-dev \
- libao-dev libmad0-dev libasound2-dev libdb-dev
+ libao-dev libmad0-dev libasound2-dev libdb4.3-dev \
+ libflac-dev
Mailing lists:
http://www.chiark.greenend.org.uk/mailman/listinfo/sgo-software-discuss
--without-gtk Don't build GTK+ client (Disobedience)
--without-python Don't build Python support
- See README.client for setting up a standalone client.
+ See README.client for setting up a standalone client (or read the
+ disobedience man page).
+
+ The server is only built by default under Linux. See README.mac concerning
+ its use under OS X.
2. Install it. Most of the installation is done via the install target:
make installdirs install
- The CGI interface has to be installed separately, and you must use Libtool
- to install it. For instance:
+ The CGI interface has to be installed separately:
- ./libtool --mode=install install -m 755 progs/disorder.cgi /usr/local/lib/cgi-bin/disorder
+ install -m 755 clients/disorder.cgi /usr/local/lib/cgi-bin/disorder
Depending on how your system is configured you may need to link the disorder
libao driver into the right directory:
4. Create /etc/disorder/config. Start from examples/config.sample and adapt it
to your own requirements. In particular, you should:
- * edit the 'player' commands to reflect the software you have installed.
+ * add 'player' commands for any file formats not supported natively
* edit the 'collection' command to identify the location(s) of your own
digital audio files. These commands also specify the encoding of
filenames, which you should be sure to get right as recovery from an
suitable; install it in /etc/init.d, adapting it as necessary, and make
appropriate links from /etc/rc[0-6].d.
- For Mac OS X 10.4, a suitable plist file is automatically installed. The
- command:
-
- sudo launchctl list
-
- ...should show "uk.org.greenend.rjk.disorder" (among other things).
-
- If you have a some other init system then you are on your own.
-
7. Make sure the state directory (/var/disorder or /usr/local/var/disorder or
as determined by configure) exists and is writable by the jukebox user.
/etc/init.d/disorder start
- On Mac OS X 10.4:
-
- sudo launchctl start uk.org.greenend.rjk.disorder
-
By default disorderd logs to daemon.*; check your syslog.conf to see where
this ends up and look for log messages from disorderd there. If it didn't
start up correctly there should be an error message. Correct the problem