Rename E_BAD_DBTOOL to E_BAD_SELECTOR
[paraslash.git] / index.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2    "http://www.w3.org/TR/html4/loose.dtd">
3 <html>
4 <head>
5         <meta http-equiv='Content-Type' content='text/html; charset=iso-8859-1'>
6         <title>Paraslash</title>
7         <style type="text/css">
8                 body {
9                         background-color: #000000;
10                         color: #cccccc;
11                 }
12                 :link { color: #990000 }
13                 :visited { color: #990000 }
14                 td.c2 {font-family: arial, helvetica, sans-serif; font-size: 80%}
15                 td.c1 {font-family: lucida, helvetica; font-size: 248%}
16                 a:hover {background:#ff0;}
17                 a:hover img {background:#fff;}
18         </style>
19         <link rel="shortcut icon" href="paraslash.ico">
20 </head>
21 <body>
22         <basefont face="lucida, helvetica, arial" size="3">
23         <table border="0" cellpadding="0" cellspacing="0">
24         <tr>
25                 <td>
26                         <a href="/"><IMG SRC="paraslash.png" alt="paraslash" border="0"></a><BR>
27                 </td>
28                 <td>
29                         <h3>Paraslash: Play, archive, rate and stream
30                         large audio sets happily</h3>
31
32                         A set of tools for doing just what its name
33                         suggests.
34                 </td>
35         </tr>
36         <tr>
37                 <td valign="TOP">
38                         <br><a href="#feature_list">Feature list</a>
39                         <br><a href="#screenshots">Screenshots</a>
40                         <br><a href="#download">Download</a>
41                         <br><a href="#live_demo">Live Demo</a>
42                         <br><a href="#changes">Changes</a> <br><a
43                         href="#documentation">Documentation</a>
44                         <br><a href="#license">License</a> <br><a
45                         href="#author">Author</a>
46                 </td>
47                 <td Valign="TOP">
48         <hr>
49                         <h3>Events</h3>
50                         <ul>
51                                 <li>2005-12-27: paraslash-0.2.7 "transparent invariance"</li>
52                                 <li>2005-10-29: paraslash-0.2.6 "recursive compensation"</li>
53                                 <li>2005-10-27: <a href="doc/html/index.html">manual pages</a> online</li>
54                                 <li>2005-10-13: paraslash-0.2.5 "aggressive resolution"</li>
55                                 <li>2005-09-21: paraslash-0.2.4 "toxic anticipation"</li>
56                                 <li>2005-09-01: paraslash-0.2.3 "hydrophilic movement"</li>
57                                 <li>2005-08-19: paraslash-0.2.2 "tangential excitation"</li>
58                                 <li>2005-08-15: paraslash-0.2.1 "surreal experience"</li>
59                                 <li>2005-08-06: overview.pdf</li>
60                                 <li>2005-08-06: paraslash-0.2.0 "distributed diffusion"</li>
61                                 <li>2005-08-01: paraslash live stream</li>
62                                 <li>2005-04-18: paraslash-0.1.7 "melting penetration"</li>
63                                 <li>2005-03-05: paraslash-0.1.6 "asymptotic balance"</li>
64                                 <li>2004-12-31: paraslash-0.1.5 "opaque eternity"</li>
65                                 <li>2004-12-19: paraslash-0.1.4 "tunneling transition"</li>
66                                 <li>2004-12-10: paraslash-0.1.3 "vanishing inertia"</li>
67                                 <li>2004-11-28: paraslash-0.1.2 "spherical fluctuation"</li>
68                                 <li>2004-11-05: paraslash-0.1.1 "floating atmosphere"</li>
69                                 <li>2004-10-22: paraslash-0.1.0 "rotating cortex"</li>
70                         </ul>
71                         <hr>
72                         <h3><a name="feature_list">Feature list</a></h3>
73                         <ul>
74                                 <li>network audio streaming software</li>
75                                 <li>client/server tcp-networking</li>
76                                 <li>command line interface</li>
77                                 <li> <a href="http://www.openssl.org/">openssl</a> user authentication</li>
78                                 <li>several grafical user interfaces</li>
79                                 <li> <a href="http://www.mysql.com">mysql</a>-based audio file selector</li>
80                         </ul>
81                         See <a href="FEATURES.html">FEATURES</a> for a more detailed list.
82                         <hr>
83
84         <h3><a name="screenshots">Screenshots</a></h3>
85         Everybody loves screenshots, so
86                 <a href="screenshots/">here</a>
87         we go.
88         <hr>
89
90         <h3><a name="download">Download</a></h3>
91
92                 <p> Only <a href="versions/">source</a> is available,
93                 including the <a href="versions/paraslash-cvs.tar.bz2">
94                 nightly cvs snapshot</a>. All regular releases are
95                 <a href="PUBLIC_KEY">cryptographically signed</a>.
96                 Anonymous (read-only) cvs access is also
97                 available. Checkout a copy with </p>
98
99                 <p> cvs -d
100                 :pserver:anonymous@cvs.systemlinux.org:/var/lib/cvs
101                 login </p>
102                 <p>(empty passwd)</p>
103                 <p> cvs -d :pserver:anonymous@cvs.systemlinux.org:/var/lib/cvs co paraslash </p>
104
105
106                 <p> Finally, you can <a href="HTML/index.html">RTFS online</a>.
107         <hr>
108
109         <h3><a name="live_demo">Live Demo</a></h3>
110
111         <p> There is a public paraslash stream at www.paraslash.org,
112         streaming
113
114                 <a href="http://www.digitalvibes.de/">the music of Henri Petterson</a>.
115
116
117         You can listen to the stream with any mp3 player that supports
118         http streaming. Both </p>
119
120                 <p>mpg123 http://www.paraslash.org:8009/</p>
121
122         and
123
124                 <p>xmms http://www.paraslash.org:8009/</p>
125
126         <p> are known to work.</p>
127
128         <p> Moreover, there is an anonymous paraslash account
129         available which you can use to have a look at paraslash
130         without configuring and running para_server on your own box.
131         Just download and run
132
133                 <a href="demo-script">this shell script</a>
134
135         on your Unix system. If you prefer to do things manually,
136         simply cut-and-paste the instructions given below verbatim
137         to your shell. No root-privileges are required.</p>
138
139 <ul>
140                 <li>
141                         Check that both aplay and mpg123 are installed on your system
142         </li>
143
144                 <li>
145                         <a href="versions">Download </a>
146                         a recent paraslash package. You
147                         you need paraslash-0.2.0 or later
148                         for the demo, paraslash-0.1.x will not work.
149                 </li>
150
151                 <li>
152
153                         Install the neccessary paraslash binaries
154                         (you can safely ignore any warnings about
155                         missing software):
156
157                         <ul>
158                                 <li>tar xjf paraslash-cvs.tar.bz2</li>
159                                 <li>cd paraslash-cvs</li>
160                                 <li>bin="para_client para_audioc para_audiod para_gui" # all we need
161                                 <li>(./configure --prefix="$HOME" && make $bin) > /dev/null</li>
162                                 <li> mkdir -p $HOME/bin; cp $bin $HOME/bin
163                                 <li> export PATH=$HOME/bin:$PATH
164
165                         </ul>
166                         There should be no errors.
167                 </li>
168                 <li>
169                         Get the key for the anonymous account on
170                         www.paraslash.org:
171
172                         <ul>
173                                 <li> dir="$HOME/.paraslash"; server=www.paraslash.org</li>
174                                 <li> mkdir -p $dir</li>
175                                 <li> wget --directory-prefix=$dir http://$server/key.anonymous</li>
176                         </ul>
177                 </li>
178                 <li>
179                         Tell para_client that we want to connect to
180                         www.paraslash.org as user anonymous:
181
182                         <ul>
183                         <li> conf="$dir/client.conf"; socket="$dir/socket"</li>
184                         <li> echo user \"anonymous\" > $conf</li>
185                         <li> echo hostname \"$server\" >> $conf</li>
186                         <li> echo key_file \"$dir/key.anonymous\" >> $conf</li>
187                         <li> echo socket \"$socket\" >> $dir/audioc.conf</li>
188                         </ul>
189                 </li>
190                 <li>
191                         Start para_audiod
192                         <ul> <li>
193
194                                 para_audiod -d --stream_read_cmd
195                                 "mp3:mpg123 -s http://$server:8009/"
196                                 --stream_write_cmd "mp3:aplay -fcd" -L $dir/audiod.log
197                                 --socket=$socket
198
199                         </li> </ul>
200                 </li><li>
201                         Start para_gui
202                         <ul> <li>
203                                 para_gui
204                         </li> </ul>
205                 </li>
206         </ul> <hr>
207
208
209         <h3><a name="changes">Changes</a></h3>
210         Read the complete
211                 <a href="ChangeLog.html">ChangeLog</a>
212         or the file
213                 <a href="NEWS.html">NEWS</a>
214         containing a brief summary of the changes for each version.
215         <hr>
216
217
218         <h3><a name="documentation">Documentation</a></h3>
219         Have a look at this
220                 <a href="overview.pdf">overview</a>,
221         a pdf file containing a sketch which illustrates how the pieces of paraslash work
222         together. Read
223                 <a href="README.html">README</a>
224         for general information,
225                 <a href="INSTALL.html">INSTALL</a>
226         for installation notes, and
227                 <a href="README.mysql.html">README.mysql</a>
228         for instructions on how to use the mysql database tool
229         shipped with paraslash. There is also an online version
230         of paraslash's
231                 <a href="doc/html/index.html">manual pages</a>.
232         <hr>
233
234         <h3><a name="license">License</a></h3>
235         Distribution of Paraslash is covered by the GNU GPL. See file
236                 <a href="COPYING.html">COPYING</a>.
237         <hr>
238
239         <h3><a name="author">Author</a></h3>
240         Andr&eacute; Noll,
241                 <a href="mailto:maan@systemlinux.org"
242                 >maan@systemlinux.org</a>
243         <p>
244         Several people helped by reporting bugs, improving documentation,
245         constructive discussions, or, last but not least, by writing
246         free software on which this project is based on. See
247                 <a href="CREDITS.html">CREDITS</a>
248         for an incomplete list of people.
249         <hr>
250
251
252         Last modified:
253         <!--#flastmod virtual="" -->
254         <p>
255         <a href="http://validator.w3.org/check?uri=referer"><img border="0"
256           src="http://www.w3.org/Icons/valid-html401"
257           alt="Valid HTML 4.01!" height="31" width="88"></a>
258         </p>
259
260         </td>
261         </table>
262 </body>
263 </html>