rename dopey to random
[paraslash.git] / FEATURES
1 Features
2 ========
3
4 configurable audio streaming software
5 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
6 para_server streams binary audio data (mp3/ogg files) over
7 local or remote networks. It contains two built-in streamers:
8 the http streamer and the ortp streamer.
9
10 para_audiod runs on the client side and connects to
11 para_server. The audio stream is read back and sent through
12 any of paraslash's filters (mp3 decoder, ogg vorbis decoder,
13 volume normalizer,...) and the resulting stream is written to
14 an external program's standard in, usually an audio player,
15 like para_play that uses alsa. It is possible to grab the
16 stream at any position in the filter chain.
17
18 The receiving/filtering software is also available as
19 standalone command line tool: para_recv grabs the http or ortp
20 stream and writes to stdout; para_filter reads from stdin,
21 converts the stream according to the given --filter command
22 line options and writes the transformed stream to stdout.
23
24 mysql-based audio file selector:
25 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
26 the (optional) mysql database tool manages some statistics on
27 your audio files. It contacts the mysql server to decide which
28 song to play next by sending a user-defined sql-query. This
29 allows rather sophisticated configurations and is explained
30 in detail in README.mysql.
31
32 small memory footprint:
33 ~~~~~~~~~~~~~~~~~~~~~~~
34 paraslash is lightweight. The stripped binary of para_server
35 with all its features compiled in (mysql/random dbtool,
36 mp3/ogg support, http/ortp support) is about 100K on i386
37 under Linux. para_audiod is even smaller.
38
39 command line interface, including shell:
40 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
41 para_client without arguments starts interactive (shell)
42 mode. Otherwise, command is sent to para_server directly
43 and output is dumped to stdout. This can be used by any
44 scripting language to produce user interfaces with very little
45 programming effort.
46
47 authentication/encryption via openssl:
48 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
49 All connections between para_server and para_client are
50 encrypted by default. For each user of paraslash you must
51 create a public/secret key pair for authentication/encryption.
52
53 various user interfaces and utilities:
54 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
55 o para_gui. Curses based interface, displays information in a
56 curses window and can be used to easily control para_server
57 and para_audiod.
58
59 o para_sdl_gui. Shows pictures (on a per song basis) and
60 other information about the current audio file. Can be used
61 as a screen saver.
62
63 o para_krell. A gkrellm2 plugin that shows small pics and is
64 able to launch 27 different commands by clicking on the image.
65
66 o para_slider. User-friendly stream creator for people who
67 don't like their keyboard.
68
69 o para_dbadm. Simple curses interface for changing attributes.
70
71 o para_fade. Simple volume fader and alarm clock.