X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=FEATURES;h=7fdd23996732a677765c6f4e850a92b14a69d182;hp=17d5051c81647e982e4c713ca09e65b36eb503d0;hb=fa54361d9eb07f22cbe6a59faa6321700b807f49;hpb=fee01885fb4c6cef1909ebd753050327ee977aee diff --git a/FEATURES b/FEATURES index 17d5051c..7fdd2399 100644 --- a/FEATURES +++ b/FEATURES @@ -1,41 +1,38 @@ Features ======== -configurable audio streaming software -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +configurable audio streaming software: +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ para_server streams binary audio data (mp3/ogg files) over - local or remote networks. It contains two built-in streamers: - the http streamer and the ortp streamer. + local and/or remote networks. It supports three builtin + streaming methods (senders): http, dccp, or rtp. para_audiod runs on the client side and connects to - para_server. The audio stream is read back and sent through - any of paraslash's filters (mp3 decoder, ogg vorbis decoder, - volume normalizer,...) and the resulting stream is written to - an external program's standard in, usually an audio player, - like para_play that uses alsa. It is possible to grab the - stream at any position in the filter chain. + para_server. The audio stream is read from the network and + sent through any of paraslash's filters (mp3 decoder, ogg + vorbis decoder, volume normalizer,...). The resulting stream + is written to an external program's standard in, usually an + audio player like para_write, which comes with paraslash and + contains an alsa player. It is possible to capture the stream + at any position in the filter chain. The receiving/filtering software is also available as - standalone command line tool: para_recv grabs the http or ortp - stream and writes to stdout; para_filter reads from stdin, - converts the stream according to the given --filter command - line options and writes the transformed stream to stdout. + standalone command line tool: para_recv reads the stream and + writes to stdout; para_filter reads from stdin, converts the + stream according to the given --filter command line options + and writes the transformed stream to stdout. configurable audio file selectors: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - There are three audio file selectors (aka "database tools") - available: - - - random - - plm (playlist manager) - - mysql + There are three audio file selectors available: random, + playlist and mysql The first two of these are rather simple, and they are always supported. They allow streaming of randomly selected files or files given by a playlist respectively. The (optional) mysql selector is more involved. It manages - statistics on your audio files and audio file selection is + statistics on your audio files, and audio file selection is done by sending a user-defined sql-query to the mysql server. This allows rather sophisticated configurations and is explained in detail in README.mysql. @@ -46,17 +43,15 @@ configurable audio file selectors: small memory footprint: ~~~~~~~~~~~~~~~~~~~~~~~ paraslash is lightweight. The stripped binary of para_server - with all its features compiled in (mysql/random dbtool, - mp3/ogg support, http/ortp support) is about 110K on i386 - under Linux. para_audiod is even smaller. - -command line interface, including shell: -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - para_client without arguments starts interactive (shell) - mode. Otherwise, command is sent to para_server directly - and output is dumped to stdout. This can be used by any - scripting language to produce user interfaces with very little - programming effort. + with all its features compiled in (mysql/random/playlist + selector, mp3/ogg support, http/dccp/ortp support) is about 110K + on i386 under Linux. para_audiod is even smaller. + +command line interface: +~~~~~~~~~~~~~~~~~~~~~~~ + paraslash commands are sent to para_server and the response is + dumped to stdout. This can be used by any scripting language + to produce user interfaces with little programming effort. authentication/encryption via openssl: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~