X-Git-Url: https://git.distorted.org.uk/~mdw/disorder/blobdiff_plain/22b9fa74de8e80471a5033ea067d3b360930b91d..d8653a539ff8aa8f3b27dd74fcd9cecde0ed5d86:/README diff --git a/README b/README index 414e8f5..538aee4 100644 --- a/README +++ b/README @@ -14,37 +14,41 @@ variants in some cases without too much effort. Things you will need: 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 @@ -85,7 +89,7 @@ NOTE: If you are upgrading from an earlier version, see README.upgrades. The CGI interface has to be installed separately, and you must use Libtool to install it. For instance: - ./libtool --mode=install install -m 755 progs/disorder.cgi /usr/local/lib/cgi-bin/disorder + ./libtool --mode=install 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: @@ -101,9 +105,15 @@ NOTE: If you are upgrading from an earlier version, see README.upgrades. Do not use a general-purpose user or group, you must create ones specifically for DisOrder. + Under OS X, make sure that ~jukebox/Library/Logs/CrashReporter/ (or + whatever) exists and is writable by the jukebox user. + + mkdir -p ~jukebox/Library/Logs/CrashReporter + chown -R jukebox:jukebox ~jukebox/Library + 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 @@ -144,12 +154,13 @@ NOTE: If you are upgrading from an earlier version, see README.upgrades. 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: + For Mac OS X 10.4, you can install server/uk.org.greenend.rjk.disorder.plist + into /Library/LaunchDaemons. Having done this reload the contents: - sudo launchctl list + sudo launchctl load /Library/LaunchDaemons - ...should show "uk.org.greenend.rjk.disorder" (among other things). + Note that the RunAtLoad key has been deliberately commented out, if you want + to start the server at boot time you must edit this. If you have a some other init system then you are on your own.