X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=INSTALL;h=adb75c5c6e02c0f8528485d3fa3d959762b1e801;hp=9d82c9bf239bc130ce3eb1b1b7782558a1e5fa97;hb=72c44464f1fd0cf0c253da784027fe6143bff536;hpb=c141cc6915a32fb92766dc27f0df222d13f27d8b diff --git a/INSTALL b/INSTALL index 9d82c9bf..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 your database tool (dbtool) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -You have two options: - - 1. Use the mysql dbtool which comes with paraslash and requires - mysql. - - 2. If you can not use the mysql dbtool and you just want - to quickly make paraslash working, use the random dbtool. - The directory which is searched for audio files can be given - via the server option --random_dbtool_dir. - - Note, however, that this database tool is really dopey. It - scans the given directory on every audio file change and - chooses one randomly. There is no further functionality. - -The current database tool can be changed at runtime via - - para_client cdt new_dbtool - -If you have choosen 1. above, read README.mysql and follow the -instructions given there. Return to this document when ready. - - Start streaming manually ~~~~~~~~~~~~~~~~~~~~~~~~ @@ -115,19 +98,43 @@ on client_host: mp3: - para_recv -r http:-i:server_host | para_filter -f mp3 -f wav | para_play - or - mpg123 http://server_host:8000/ - or - xmms http://server_host:8000/ + para_recv -r 'http -i server_host' | para_filter -f mp3dec -f wav | para_write -w alsa + or + mpg123 http://server_host:8000/ + or + xmms http://server_host:8000/ ogg: - para_recv -r http:-i:server_host | para_filter -f ogg -f wav | para_play + 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), +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 -If this works, proceede. Otherwise doublecheck what is logged by -para_server and use the --loglevel option of para_recv to increase -verbosity. Configure para_audiod ~~~~~~~~~~~~~~~~~~~~~ @@ -142,7 +149,7 @@ the audio stream. Try for help. Usually you have to specify at least server_host as the receiver specifier, like this: - -r http:-i:server_host + -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" @@ -173,23 +180,23 @@ information in a curses window. It also allows you to bind keys to arbitrary commands. There are several flavours of key-bindings: o internal: These are the built-in commands that can not be - changed (help, quit, loglevel, version...). + changed (help, quit, loglevel, version...). - o external: Shutdown curses before launching the given command. - Useful for starting other ncurses programs from within - para_gui, e.g. aumix or para_dbadm. Or, use + o external: Shutdown curses before launching the given command. + Useful for starting other ncurses programs from within + para_gui, e.g. aumix or para_dbadm. Or, use para_client mbox - to write a mailbox containing one mail for each file - in the mysql database and start mutt from within para_gui - to browse your collection! + to write a mailbox containing one mail for each file + in the mysql database and start mutt from within para_gui + to browse your collection! o display: Launch the command and display its stdout in - para_gui's bottom window. + para_gui's bottom window. o para: Like display, but start "para_client " instead of "". + command>" instead of "". That's all, congratulations. Check out all the other optional gimmics!