simplify open_audiod_pipe(), remove a trailing newline which caused
[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>