Document disorder-playrtp --command in CHANGES.html
[disorder] / CHANGES.html
1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2 <html>
3 <head>
4 <title>DisOrder Change History</title>
5 <style type="text/css">
6 body {
7 color: black;
8 background-color: white;
9 font-family: times,serif;
10 font-weight: normal;
11 font-size: 12pt;
12 font-variant: normal
13 }
14
15 div.section {
16 margin-left:1em
17 }
18
19 h1 {
20 background-color: #e0ffe0;
21 font-family: helvetica,sans-serif;
22 padding: 0.2em
23 }
24
25 h2 {
26 background-color: #e0ffe0;
27 font-family: helvetica,sans-serif;
28 padding: 0.2em
29 }
30
31 h3 {
32 background-color: #f0f0f0;
33 font-family: helvetica,sans-serif;
34 padding: 0.2em
35 }
36
37 h4 {
38 font-family: helvetica,sans-serif
39 }
40
41 table.bugs {
42 width: 100%
43 }
44
45 table.bugs th {
46 text-align: left
47 }
48
49 span.command {
50 font-family: monospace
51 }
52 </style>
53 </head>
54
55 <body>
56 <h1>DisOrder Change History</h1>
57
58 <p>This file documents recent user-visible changes to <a
59 href="http://www.greenend.org.uk/rjk/disorder/">DisOrder</a>.</p>
60
61 <h2>Changes up to version 4.4</h2>
62
63 <div class=section>
64
65 <h3>Server</h3>
66
67 <div class=section>
68
69 <p>The <tt>device</tt> configuration option work under OS X. Devices may
70 be specified either by UID or name. Fixes <a
71 href="http://code.google.com/p/disorder/issues/detail?id=27">Issue
72 27</a>.</p>
73
74 </div>
75
76 <h3>RTP Player</h3>
77
78 <div class=section>
79
80 <p>There is a new <tt>--command</tt> option which allows the RTP player
81 to send audio data to a user-chosen command instead of an audio API. See
82 the man page for details.</p>
83
84 <p>The <tt>--device</tt> option to <tt>disorder-playrtp</tt> now works
85 under OS X (as above).</p>
86
87 </div>
88
89 <h3>Bugs fixed</h3>
90
91 <div class=section>
92
93 <table class=bugs>
94 <tr>
95 <th>ID</th>
96 <th>Description</th>
97 </tr>
98
99 <tr>
100 <td><a href="http://code.google.com/p/disorder/issues/detail?id=27">#27</a></td>
101 <td>Mac DisOrder uses wrong sound device</td>
102 </tr>
103
104 </table>
105
106 </div>
107 </div>
108
109 <h2>Changes up to version 4.3</h2>
110
111 <div class=section>
112
113 <h3>Disobedience</h3>
114
115 <div class=section>
116
117 <p>A bug was fixed in the calculation of how much of the track had
118 played. This would lead to the counter showing incorrect values in
119 various situations.</p>
120
121 <p>Disobedience's icons have been changed to larger, more colorful
122 ones. The SVG source is included if you want to fiddle with them.</p>
123
124 <p>&ldquo;Select all&rdquo; is now no longer available in the choose
125 tab. Instead there is a new &ldquo;Select children&rdquo; option which
126 selects the file children of a single subdirectory.</p>
127
128 </div>
129
130 <h3>Server</h3>
131
132 <div class=section>
133
134 <p>The selection bias for newly added tracks was reduced by half. You
135 can put it back to the old very neophilic value with
136 &ldquo;<tt>new_bias 900000</tt>&rdquo; in the config file.</p>
137
138 <p>It is now possible to &lsquo;adopt&rsquo; randomly picked tracks.
139 Disobedience and the command-line client support this but the web
140 interface does not.</p>
141
142 <p>The default track name parsing was modified to handle filenames
143 generated by iTunes.</p>
144
145 </div>
146
147 <h3>Miscellaneous</h3>
148
149 <div class=section>
150
151 <p><tt>disorderfm</tt> now preserves directory permissions.</p>
152
153 <p>DisOrder is now licensed under <a
154 href="http://www.gnu.org/licenses/gpl-3.0.html">GPL v3</a>. The main
155 goal is to prohibit <a
156 href="http://en.wikipedia.org/wiki/Tivoization">Tivoization</a>.</p>
157
158 <p>The build system will now automatically cope with Fink's broken GTK+
159 packages. There are a number of improvements to the Debian
160 packaging.</p>
161
162 <p>DisOrder now builds on 64-bit Linux systems.</p>
163
164 <p>There are various minor fixes.</p>
165
166 </div>
167
168 <h3>Bugs fixed</h3>
169
170 <div class=section>
171
172 <table class=bugs>
173 <tr>
174 <th>ID</th>
175 <th>Description</th>
176 </tr>
177
178 <tr>
179 <td><a href="http://code.google.com/p/disorder/issues/detail?id=24">#24</a></td>
180 <td>Fails to build on ubuntu 8.10</td>
181 </tr>
182 <tr>
183 <td><a href="http://code.google.com/p/disorder/issues/detail?id=26">#26</a></td>
184 <td>Disobedience shows wrong track elapsed time after a pause</td>
185 </tr>
186 </table>
187
188 </div>
189 </div>
190
191 <h2>Changes up to version 4.2</h2>
192
193 <div class=section>
194
195 <h3>Disobedience</h3>
196
197 <div class=section>
198
199 <p>The login window now has a 'remote' switch. If this is turned off
200 then Disobedience will connect to a local server. Formerly it would
201 always use TCP/IP.</p>
202
203 <p>The Delete and backspace keys will now remove tracks from the queue.
204 Escape will now dismiss the properties, users or login windows and return
205 now works in the login and properties windows.</p>
206
207 </div>
208
209 <h3>Documentation</h3>
210
211 <div class=section>
212
213 <p>Track and global preferences are now described in a new
214 <b>disorder_preferences</b>(5) man page.</p>
215
216 </div>
217
218 <h3>Bugs fixed</h3>
219
220 <div class=section>
221
222 <table class=bugs>
223 <tr>
224 <th>ID</th>
225 <th>Description</th>
226 </tr>
227
228 <tr>
229 <td><a href="http://code.google.com/p/disorder/issues/detail?id=21">#21</a></td>
230 <td>CGI should use PATH_INFO more sensibly</td>
231 </tr>
232 </table>
233
234 </div>
235 </div>
236
237
238 <h2>Changes up to version 4.1.1</h2>
239
240 <div class=section>
241
242 <p>Disobedience's &ldquo;Login&rdquo; window now works when you are logged
243 in.</p>
244
245 </div>
246
247 <h2>Changes up to version 4.1</h2>
248
249 <div class=section>
250
251 <h3>Disobedience</h3>
252
253 <div class=section>
254
255 <p>Disobedience has been largely rewritten:</p>
256
257 <ul>
258
259 <li>All the tabs now use native GTK+ list/tree widgets, resulting in
260 greater speed in some cases and more consistency with other GTK+
261 applications.</li>
262
263 <li>You can now use type-ahead find in the choose tab. The initiation
264 of a search is delayed slightly to avoid lots of updates when you're
265 half way through entering search terms.</li>
266
267 <li>The choose tab now shows track lengths.</li>
268
269 <li>Many buttons are now more reliably made insensitive when they can't
270 be used.</li>
271
272 <li>You can now play tracks off the recent tab.</li>
273
274 </ul>
275
276 <p>Disobedience attempts to cope with servers from older versions, up to
277 a point, but this is not well tested and it's best to keep the server
278 fully up to date.</p>
279
280 </div>
281
282 <h3>Server</h3>
283
284 <div class=section>
285
286 <p>When a track shares a directory with its alias, the real track name is
287 now returned instead of the alias (the opposite way round to the previous
288 behaviour).</p>
289
290 </div>
291 </div>
292
293 <h2>Changes up to version 4.0.2</h2>
294
295 <div class=section>
296
297 <p>Corrected web browser linked from Disobedience.</p>
298
299 </div>
300
301 <h2>Changes up to version 4.0.1</h2>
302
303 <div class=section>
304
305 <p>Libtool and Automake now install the CGI correctly. As part of this,
306 <tt>cgidir</tt> has been renamed to <tt>cgiexecdir</tt>. The configure
307 script will report an error if you try to use the old name.</p>
308
309 </div>
310
311 <h2>Changes up to version 4.0</h2>
312
313 <div class=section>
314
315 <h3>Server</h3>
316
317 <div class=section>
318
319 <p>The <tt>gap</tt> directive will no longer work. It could be
320 restored if there is real demand.</p>
321
322 <h4>Event Scheduling</h4>
323
324 <div class=section>
325
326 <p>It is now possible to schedule events to occur in the future.
327 Currently the supported actions are playing a specific track, and
328 changing a global preference (thus allowing e.g. random play to be
329 turned on or off). See the <tt>schedule-*</tt>
330 commands described in disorder(1).</p>
331
332 </div>
333
334 <h4>Random Track Choice</h4>
335
336 <div class=section>
337
338 <p>This has been completely rewritten to support new features:</p>
339
340 <ul>
341
342 <li>tracks in the recently-played list or in the queue are no longer
343 eligible for random choice.</li>
344
345 <li>there is a new <tt>weight</tt> track preference allowing for
346 non-uniform track selection. See disorder(1) for details.</li>
347
348 <li>there is a new configuration item <tt>replay_min</tt> defining
349 the minimum time before a played track can be picked at random.
350 The default is 8 hours (which matches the earlier behaviour).</li>
351
352 <li>recently added tracks are biased up; see <tt>new_bias</tt> and
353 <tt>new_bias_age</tt> in disorder_config(5).</li>
354
355 </ul>
356
357 </div>
358
359 <h4>Web Interface</h4>
360
361 <div class=section>
362
363 <p>This has been largely rewritten. The most immediate benefits are:</p>
364
365 <ul>
366
367 <li>the search page is integrated into the choose page, and
368 includes links to parent directories.</li>
369
370 <li>if you try to do something you have insufficient rights for,
371 instead of getting an error page or nothing happening, you are
372 redirected to the login page.</li>
373
374 </ul>
375
376 <p>Customizers should find their lives easier: the syntax is less onerous, it
377 is possible to define macros to avoid repetition, and the documentation is
378 less monolithic (see disorder.cgi(8) as a starting point).</p>
379
380 <p>Mail is now sent via the system sendmail program, though it remains
381 possible to use TCP to connect to an SMTP server. See <tt>sendmail</tt> and
382 <tt>smtp_server</tt> in disorder_config(5).</p>
383
384 <p>The web interface is now installed automatically. If you don't want it,
385 use <tt>./configure --without-cgi</tt>. If you want it in a non-default
386 location, or no location for it is detected, set <tt>cgidir</tt>
387 and <tt>httpdir</tt> on the <tt>./configure</tt> command line.</p>
388
389 </div>
390
391 </div>
392
393 <h3>Disobedience</h3>
394
395 <div class=section>
396
397 <p>There is now a new user management window. From here you can add and
398 remove users or modify their settings.</p>
399
400 <p>Relatedly, the server will only allow remote user management if you set
401 <tt>remote_userman</tt> to <tt>yes</tt>.</p>
402
403 </div>
404
405 <h3>Miscellaneous</h3>
406
407 <div class=section>
408
409 <p><tt>scripts/setup</tt> now honors command line options, and can
410 set up network play as well as the local default sound device.</p>
411
412 </div>
413
414 <h3>Bugs Fixed</h3>
415
416 <div class=section>
417
418 <table class=bugs>
419 <tr>
420 <th>ID</th>
421 <th>Description</th>
422 </tr>
423
424 <tr>
425 <td><a href="http://code.google.com/p/disorder/issues/detail?id=2">#2</a></td>
426 <td>Search results should link to directories</td>
427 </tr>
428
429 <tr>
430 <td><a href="http://code.google.com/p/disorder/issues/detail?id=6">#6</a></td>
431 <td>Schedule tracks for a particular time</td>
432 </tr>
433
434 <tr>
435 <td><a href="http://code.google.com/p/disorder/issues/detail?id=10">#10</a></td>
436 <td>Non-uniform track selection</td>
437 </tr>
438
439 <tr>
440 <td><a href="http://code.google.com/p/disorder/issues/detail?id=11">#11</a></td>
441 <td>Bias random selection to newly added tracks</td>
442 </tr>
443
444 <tr>
445 <td><a href="http://code.google.com/p/disorder/issues/detail?id=13">#13</a></td>
446 <td>Default encoding for debian setup scripts</td>
447 </tr>
448
449 <tr>
450 <td><a href="http://code.google.com/p/disorder/issues/detail?id=16">#16</a></td>
451 <td>Cookie expiry causes user to be silently logged out and not
452 subsequently redirected to login page</td>
453 </tr>
454
455 <tr>
456 <td><a href="http://code.google.com/p/disorder/issues/detail?id=20">#20</a></td>
457 <td>Broken aliasing rules</td>
458 </tr>
459
460 </table>
461
462 </div>
463
464 </div>
465
466 <h2>Changes up to version 3.0.2</h2>
467
468 <div class=section>
469
470 <p>Builds <tt>--without-server</tt> should work again.</p>
471
472 <p>The web interface is a bit more liberal in the cookie value
473 syntax it will accept.</p>
474
475 <p>Clients fail more gracefully if no password is available.</p>
476
477 </div>
478
479 <h2>Changes up to version 3.0.1</h2>
480
481 <div class=section>
482
483 <p>Debian upgrades from 2.0.x should now work better.</p>
484
485 </div>
486
487 <h2>Changes up to version 3.0</h2>
488
489 <div class=section>
490
491 <p><b>Important</b>! See <a
492 href="README.upgrades">README.upgrades</a> when upgrading.</p>
493
494 <h3>Platforms And Installation</h3>
495
496 <div class=section>
497
498 <p>Mac OS X and FreeBSD are somewhat supported. There is now a bash
499 script in <tt>scripts/setup</tt> which will automate the setup after
500 <tt>make install</tt>.</p>
501
502 </div>
503
504 <h3>Server</h3>
505
506 <div class=section>
507
508 <p>Users are now stored in the database rather than a configuration
509 file.</p>
510
511 <p>The server now has a built-in list of stopwords and players, so
512 only additions to these need be mentioned in the configuration file.</p>
513
514 <p>The default inter-track gap is now 0s.</p>
515
516 <p>How sound is played is now controlled via the new <tt>api</tt>
517 configuration command. This also controls how the volume is set,
518 which now works with ALSA as well as OSS.</p>
519
520 <p>A bug in the MP3 decoder was fixed (also in 2.0.4).</p>
521
522 </div>
523
524 <h3>Web Interface</h3>
525
526 <div class=section>
527
528 <p>The web interface now uses cookies to remember user identity, and
529 allows online registration of new users. Also it is no longer
530 necessary to manually specify the URL of the web interface (but you
531 can override it if you don't like the value it figures out).</p>
532
533 <p>It is possible to allow users to register via the web interface.</p>
534
535 <p>The web interface's browser support has been improved. It has
536 been tested with Firefox 2, Safari 3, Konqueror 3, Internet Explorer
537 7 and Opera 9.</p>
538
539 </div>
540
541 <h3>Disobedience</h3>
542
543 <div class=section>
544
545 <p>A bug which would cause a crash if you attempt to rearrange the
546 queue while no track was playing has been fixed. There is a new
547 'deselect all tracks' option, mirroring 'select all tracks.</p>
548
549 </div>
550
551 </div>
552
553 <!--
554 Local Variables:
555 fill-column:79
556 indent-tabs-mode:nil
557 End:
558 -->