From 856d16551da3cc1903406f329c4686e26280b08e Mon Sep 17 00:00:00 2001 From: Andre Date: Thu, 20 Apr 2006 22:36:05 +0200 Subject: [PATCH] INSTALL: Add more explanations for unexperienced users. --- INSTALL | 65 ++++++++++++++++++++++++++++++++------------------------- 1 file changed, 36 insertions(+), 29 deletions(-) diff --git a/INSTALL b/INSTALL index f0d1ec8c..adb75c5c 100644 --- a/INSTALL +++ b/INSTALL @@ -32,7 +32,8 @@ want to allow to connect. You need at least one user. Let's assume that you'd like to run the server on host server_host as user foo, and that you want to connect from client_host as user bar. -As foo@server_host, create ~/.paraslash/server.users: +As foo@server_host, create ~/.paraslash/server.users by typing the +following commands: target=~/.paraslash/server.users key=~/.paraslash/key.pub.bar @@ -54,7 +55,9 @@ Next, extract its public part: pubkey=~/.paraslash/key.pub.bar openssl rsa -in $key -pubout -out $pubkey -and copy the public key just created to server_host: +and copy the public key just created to server_host (you may +skip this step for a single-user setup, i.e. if foo=bar and +server_host=client_host): scp $pubkey foo@server_host:.paraslash/ @@ -64,7 +67,12 @@ Finally, tell para_client to connect to server_host: Start para_server ~~~~~~~~~~~~~~~~~ - para_server +For the first try, we'll use the default audio file selector, the +"random" selector which chooses audio files from the given directory +by random. You have to tell para_server via the --random_dir command +line option where this selector should look for audio files. + + para_server --random_dir=/my/mp3/directory Now you can use para_client to connect to the server and issue commands. Open a new shell (as "bar" on "client_host" in the above @@ -75,31 +83,6 @@ example) and try to retrieve the list of available commands and some server info. - -Choose an audio file selector -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -paraslash has three different audio file selectors: random (default), -playlist and mysql. - - The random selector chooses files randomly from the given - directory. - - The playlist selector allows to send a playlist to para_server - via the lpl (load playlist) command. para_server will choose - files from the loaded playlist in sequential order. - - The mysql selector stores information about your audio - files in a mysql database. It is much more involved than - the other two selectors and lets you chose files in many - interesting ways. If you like to use the mysql selector, - read README.mysql and follow the instructions given there. - Return to this document when ready. - -The current audio file selector can be changed at runtime via - - para_client chs new_selector - - Start streaming manually ~~~~~~~~~~~~~~~~~~~~~~~~ @@ -125,10 +108,34 @@ on client_host: para_recv -r 'http -i server_host' | para_filter -f oggdec -f wav | para_write -w alsa -If this works, proceede. Otherwise doublecheck what is logged by +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), +playlist and mysql. + + The random selector chooses files randomly from the given + directory. + + The playlist selector allows to send a playlist to para_server + via the lpl (load playlist) command. para_server will choose + files from the loaded playlist in sequential order. + + The mysql selector stores information about your audio + files in a mysql database. It is much more involved than + the other two selectors and lets you chose files in many + interesting ways. If you like to use the mysql selector, + read README.mysql and follow the instructions given there. + Return to this document when ready. + +The current audio file selector can be changed at runtime via + + para_client chs new_selector + + Configure para_audiod ~~~~~~~~~~~~~~~~~~~~~ In order to automatically start the right decoder at the right time -- 2.39.5