X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=INSTALL;h=9e53e1f3dbeccf49b6ee8647673823ee54bef7c2;hp=adb75c5c6e02c0f8528485d3fa3d959762b1e801;hb=d7f72444e863fb5aae145d4e720cd71dc03578b0;hpb=856d16551da3cc1903406f329c4686e26280b08e

diff --git a/INSTALL b/INSTALL
index adb75c5c..9e53e1f3 100644
--- a/INSTALL
+++ b/INSTALL
@@ -22,7 +22,6 @@ software). Then, as root,
 
 	make install
 
-
 Setup user list and create rsa keys
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 If you already have your rsa keys, skip this step. If you are new
@@ -92,11 +91,21 @@ Start streaming manually
 This starts streaming and dumps some information on the current song
 to stdout.
 
-You should now be able to listen to the stream with any player
-capable of reading from stdin. To check this, try the following
-on client_host:
+You should now be able to receive and listen to the stream. To check
+this, try the following on client_host (assuming alsa and an mp3
+stream):
+
+	para_recv -r 'http -i server_host' > file.mp3 #interrupt after a few seconds
+	ls -l file.mp3 # should not be empty
+	para_filter -f mp3dec -f wav < file.mp3 > file.wav
+	ls -l file.wav # should be much bigger than file.mp3
+	para_write -w alsa < file.wav
 
-	mp3:
+If this works, proceed. Otherwise doublecheck what is logged by
+para_server and use the --loglevel option of para_recv, para_filter
+and para_write to increase verbosity.
+
+Next, put the pieces together:
 
 	para_recv -r 'http -i server_host' | para_filter -f mp3dec -f wav | para_write -w alsa
 	or
@@ -104,14 +113,6 @@ on client_host:
 	or
 	xmms http://server_host:8000/
 
-	ogg:
-
-	para_recv -r 'http -i server_host' | para_filter -f oggdec -f wav | para_write -w alsa
-
-If this works, proceed. Otherwise doublecheck what is logged by
-para_server and use the --loglevel option of para_recv, para_filter
-to increase verbosity.
-
 Choose an audio file selector
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 paraslash has three different audio file selectors: random (default),
@@ -147,17 +148,24 @@ the audio stream. Try
 	para_audiod -h
 
 for help. Usually you have to specify at least server_host as the
-receiver specifier, like this:
+receiver specifier for each supported audio format, like this:
 
 	-r 'mp3:http -i server_host'
 
 The prefered way to use para_audiod is to run it once at system start
 as an unprivileged user. para_audiod needs to create a "well-known"
-socket for the clients to connect to. If you want to change the
-default socket (e.g. because you do not have write access for the
-directory where the socket resides), use the -s option or the config
-file to change the default. Note that in this case you'll also have
-to specify the same value for para_audioc's -s option.
+socket for the clients to connect to. The default path for this
+socket is
+
+	/var/paraslash/audiod_socket.$HOSTNAME
+
+so the /var/paraslash directory should be owned by the user who
+runs para_audiod.
+
+If you want to change location of the default socket, use the -s
+option for para_audiod or the config file ~/.paraslash/audiod.conf
+to change the default. Note that in this case you'll also have to
+specify the same value for para_audioc's -s option.
 
 If para_server is playing, you should be able to listen to the audio
 stream as soon as para_audiod is started.  Once it is running, try