disorder-speaker now treats read errors as equivalent to EOF (apart
[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 font-size: 12pt;
44 border-collapse: collapse;
45 border:1px
46 }
47
48 table.bugs th {
49 text-align: left;
50 border: 1px solid black;
51 background-color: black;
52 color: white
53 }
54
55 table.bugs td {
56 border: 1px solid
57 }
58
59 span.command {
60 font-family: monospace
61 }
62 </style>
63 </head>
64
65 <body>
66 <h1>DisOrder Change History</h1>
67
68 <p>This file documents recent user-visible changes to <a
69 href="http://www.greenend.org.uk/rjk/disorder/">DisOrder</a>.</p>
70
71 <h2>Changes up to version 5.0</h2>
72
73 <div class=section>
74
75 <h3>Server</h3>
76
77 <div class=section>
78
79 <p>The <tt>device</tt> configuration option now works under OS X.
80 Devices may
81 be specified either by UID or name. Fixes <a
82 href="http://code.google.com/p/disorder/issues/detail?id=27">Issue
83 27</a>.</p>
84
85 <p>Gapless play should be more reliable, and playback latency over RTP
86 should be a bit lower. Note though that all the sound output code has
87 been reorganized and in some cases completely rewritten, so it's possible
88 that bugs may have been (re-)introduced. Decoding of scratches is also
89 initiated ahead of time, giving more reliable playback.</p>
90
91 <p>The <tt>command</tt> backend now (optionally) sends silence instead
92 of suspending writes when a pause occurs or no track is playing.</p>
93
94 <p>If <a href="http://www.mega-nerd.com/SRC/">libsamplerate</a> is
95 available at build time then that will be used instead of invoking
96 <a href="http://sox.sourceforge.net/">SoX</a>. SoX support will be
97 removed in a future version.</p>
98
99 <p>Playlists are now supported. These allow a collection of tracks to be
100 prepared offline and played as a unit.</p>
101
102 </div>
103
104 <h3>Disobedience</h3>
105
106 <div class=section>
107
108 <p>Multiple tracks can now be dragged in the queue in a single operation.
109 Furthermore, it is now possible to drag tracks from the
110 &ldquo;Recent&rdquo;, &ldquo;Added&rdquo; and &ldquo;Choose&rdquo; tabs
111 to the queue.</p>
112
113 <p>Disobedience now supports playlist editing and has a compact mode,
114 available from the <b>Control</b> menu.</p>
115
116 <p>Disobedience has a <a href="disobedience/manual/index.html">new
117 manual</a>.</p>
118
119 </div>
120
121 <h3>Web Interface</h3>
122
123 <div class=section>
124
125 <p>Confirmation URLs should be cleaner (and in particular not end
126 with punctuation). (Please see <a
127 href="README.upgrades">README.upgrades</a> for more about this.)</p>
128
129 </div>
130
131 <h3>RTP Player</h3>
132
133 <div class=section>
134
135 <p>There is a new <tt>--command</tt> option which allows the RTP player
136 to send audio data to a user-chosen command instead of an audio API. See
137 the man page for details.</p>
138
139 <p>The <tt>--device</tt> option to <tt>disorder-playrtp</tt> now works
140 under OS X (as above).</p>
141
142 </div>
143
144 <h3>General</h3>
145
146 <div class=section>
147
148 <p>IPv6 should now work. Network address specifications
149 (<tt>listen</tt>, <tt>connect</tt> etc) can now be prefixed with
150 <tt>-4</tt> or <tt>-6</tt> to force use
151 of IPv4 or IPv6, though normally this should not be needed.</p>
152
153 <p>Unicode support has been upgraded to <a
154 href="http://www.unicode.org/versions/Unicode5.1.0/">Unicode
155 5.1.0</a>.</p>
156
157 <p>Various elements of the source code have been
158 rationalized.</p>
159
160 </div>
161
162 <h3>Bugs fixed</h3>
163
164 <div class=section>
165
166 <table class=bugs>
167 <tr>
168 <th>ID</th>
169 <th>Description</th>
170 </tr>
171
172 <tr>
173 <td><a href="http://code.google.com/p/disorder/issues/detail?id=22">#22</a></td>
174 <td>Background decoders interact badly with server reload</td>
175 </tr>
176
177 <tr>
178 <td><a href="http://code.google.com/p/disorder/issues/detail?id=27">#27</a></td>
179 <td>Mac DisOrder uses wrong sound device</td>
180 </tr>
181
182 <tr>
183 <td><a href="http://code.google.com/p/disorder/issues/detail?id=30">#30</a></d>
184 <td>mini disobedience interface</td>
185 </tr>
186
187 <tr>
188 <td><a href="http://code.google.com/p/disorder/issues/detail?id=32">#32</a></d>
189 <td>Excessively verbose log chatter on shutdown</td>
190 </tr>
191
192 <tr>
193 <td><a href="http://code.google.com/p/disorder/issues/detail?id=33">#33</a></d>
194 <td>(Some) plugins need -lm.</td>
195 </tr>
196
197 <tr>
198 <td><a href="http://code.google.com/p/disorder/issues/detail?id=39">#39</a></d>
199 <td>Double bind() non-multicast AF_INET</td>
200 </tr>
201
202 <tr>
203 <td><a href="http://code.google.com/p/disorder/issues/detail?id=40">#40</a></d>
204 <td>Missing stub function</td>
205 </tr>
206
207 <tr>
208 <td><a href="http://code.google.com/p/disorder/issues/detail?id=41">#41</a></d>
209 <td>Missing includes for timeval</td>
210 </tr>
211
212 <tr>
213 <td><a href="http://code.google.com/p/disorder/issues/detail?id=42">#42</a></d>
214 <td>syntax error in empeg_host section</td>
215 </tr>
216
217 <tr>
218 <td><a href="http://code.google.com/p/disorder/issues/detail?id=43">#43</a></d>
219 <td>decoder segfault with FLAC 1.2.1</td>
220 </tr>
221
222 <tr>
223 <td><a href="http://code.google.com/p/disorder/issues/detail?id=44">#44</a></d>
224 <td>gcc 4.3.2-1ubuntu12 SUYB patch</td>
225 </tr>
226
227 <tr>
228 <td><a href="http://code.google.com/p/disorder/issues/detail?id=45">#45</a></d>
229 <td>disobedience doesn't configure its back end</td>
230 </tr>
231
232 <tr>
233 <td><a href="http://code.google.com/p/disorder/issues/detail?id=46">#46</a></d>
234 <td>Sort search results in web interface</td>
235 </tr>
236
237 <tr>
238 <td><a href="http://code.google.com/p/disorder/issues/detail?id=48">#48</a></d>
239 <td>build-time dependency on <tt>oggdec</tt> removed</td>
240 </tr>
241
242 <tr>
243 <td><a href="http://code.google.com/p/disorder/issues/detail?id=49">#49</a></d>
244 <td>Disobedience's 'When' column gets out of date</td>
245 </tr>
246
247 <tr>
248 <td><a href="http://code.google.com/p/disorder/issues/detail?id=51">#51</a></td>
249 <td>Improved speaker process robustness</td>
250 </tr>
251
252 <tr>
253 <td>(none)</td>
254 <td>&ldquo;found track in no collection&rdquo; messages for scratches
255 are now suppressed</td>
256 </tr>
257
258 <tr>
259 <td>(none)</td>
260 <td>Disobedience would sometimes fail to notice when a track
261 started, leading to its display getting out of date.</td>
262 </tr>
263
264 </table>
265 </div>
266 </div>
267
268 <h2>Changes up to version 4.3</h2>
269
270 <div class=section>
271
272 <h3>Disobedience</h3>
273
274 <div class=section>
275
276 <p>A bug was fixed in the calculation of how much of the track had
277 played. This would lead to the counter showing incorrect values in
278 various situations.</p>
279
280 <p>Disobedience's icons have been changed to larger, more colorful
281 ones. The SVG source is included if you want to fiddle with them.</p>
282
283 <p>&ldquo;Select all&rdquo; is now no longer available in the choose
284 tab. Instead there is a new &ldquo;Select children&rdquo; option which
285 selects the file children of a single subdirectory.</p>
286
287 </div>
288
289 <h3>Server</h3>
290
291 <div class=section>
292
293 <p>The selection bias for newly added tracks was reduced by half. You
294 can put it back to the old very neophilic value with
295 &ldquo;<tt>new_bias 900000</tt>&rdquo; in the config file.</p>
296
297 <p>It is now possible to &lsquo;adopt&rsquo; randomly picked tracks.
298 Disobedience and the command-line client support this but the web
299 interface does not.</p>
300
301 <p>The default track name parsing was modified to handle filenames
302 generated by iTunes.</p>
303
304 </div>
305
306 <h3>Miscellaneous</h3>
307
308 <div class=section>
309
310 <p><tt>disorderfm</tt> now preserves directory permissions.</p>
311
312 <p>DisOrder is now licensed under <a
313 href="http://www.gnu.org/licenses/gpl-3.0.html">GPL v3</a>. The main
314 goal is to prohibit <a
315 href="http://en.wikipedia.org/wiki/Tivoization">Tivoization</a>.</p>
316
317 <p>The build system will now automatically cope with Fink's broken GTK+
318 packages. There are a number of improvements to the Debian
319 packaging.</p>
320
321 <p>DisOrder now builds on 64-bit Linux systems.</p>
322
323 <p>There are various minor fixes.</p>
324
325 </div>
326
327 <h3>Bugs fixed</h3>
328
329 <div class=section>
330
331 <table class=bugs>
332 <tr>
333 <th>ID</th>
334 <th>Description</th>
335 </tr>
336
337 <tr>
338 <td><a href="http://code.google.com/p/disorder/issues/detail?id=24">#24</a></td>
339 <td>Fails to build on ubuntu 8.10</td>
340 </tr>
341 <tr>
342 <td><a href="http://code.google.com/p/disorder/issues/detail?id=26">#26</a></td>
343 <td>Disobedience shows wrong track elapsed time after a pause</td>
344 </tr>
345 </table>
346
347 </div>
348 </div>
349
350 <h2>Changes up to version 4.2</h2>
351
352 <div class=section>
353
354 <h3>Disobedience</h3>
355
356 <div class=section>
357
358 <p>The login window now has a 'remote' switch. If this is turned off
359 then Disobedience will connect to a local server. Formerly it would
360 always use TCP/IP.</p>
361
362 <p>The Delete and backspace keys will now remove tracks from the queue.
363 Escape will now dismiss the properties, users or login windows and return
364 now works in the login and properties windows.</p>
365
366 </div>
367
368 <h3>Documentation</h3>
369
370 <div class=section>
371
372 <p>Track and global preferences are now described in a new
373 <b>disorder_preferences</b>(5) man page.</p>
374
375 </div>
376
377 <h3>Bugs fixed</h3>
378
379 <div class=section>
380
381 <table class=bugs>
382 <tr>
383 <th>ID</th>
384 <th>Description</th>
385 </tr>
386
387 <tr>
388 <td><a href="http://code.google.com/p/disorder/issues/detail?id=21">#21</a></td>
389 <td>CGI should use PATH_INFO more sensibly</td>
390 </tr>
391 </table>
392
393 </div>
394 </div>
395
396
397 <h2>Changes up to version 4.1.1</h2>
398
399 <div class=section>
400
401 <p>Disobedience's &ldquo;Login&rdquo; window now works when you are logged
402 in.</p>
403
404 </div>
405
406 <h2>Changes up to version 4.1</h2>
407
408 <div class=section>
409
410 <h3>Disobedience</h3>
411
412 <div class=section>
413
414 <p>Disobedience has been largely rewritten:</p>
415
416 <ul>
417
418 <li>All the tabs now use native GTK+ list/tree widgets, resulting in
419 greater speed in some cases and more consistency with other GTK+
420 applications.</li>
421
422 <li>You can now use type-ahead find in the choose tab. The initiation
423 of a search is delayed slightly to avoid lots of updates when you're
424 half way through entering search terms.</li>
425
426 <li>The choose tab now shows track lengths.</li>
427
428 <li>Many buttons are now more reliably made insensitive when they can't
429 be used.</li>
430
431 <li>You can now play tracks off the recent tab.</li>
432
433 </ul>
434
435 <p>Disobedience attempts to cope with servers from older versions, up to
436 a point, but this is not well tested and it's best to keep the server
437 fully up to date.</p>
438
439 </div>
440
441 <h3>Server</h3>
442
443 <div class=section>
444
445 <p>When a track shares a directory with its alias, the real track name is
446 now returned instead of the alias (the opposite way round to the previous
447 behaviour).</p>
448
449 </div>
450 </div>
451
452 <h2>Changes up to version 4.0.2</h2>
453
454 <div class=section>
455
456 <p>Corrected web browser linked from Disobedience.</p>
457
458 </div>
459
460 <h2>Changes up to version 4.0.1</h2>
461
462 <div class=section>
463
464 <p>Libtool and Automake now install the CGI correctly. As part of this,
465 <tt>cgidir</tt> has been renamed to <tt>cgiexecdir</tt>. The configure
466 script will report an error if you try to use the old name.</p>
467
468 </div>
469
470 <h2>Changes up to version 4.0</h2>
471
472 <div class=section>
473
474 <h3>Server</h3>
475
476 <div class=section>
477
478 <p>The <tt>gap</tt> directive will no longer work. It could be
479 restored if there is real demand.</p>
480
481 <h4>Event Scheduling</h4>
482
483 <div class=section>
484
485 <p>It is now possible to schedule events to occur in the future.
486 Currently the supported actions are playing a specific track, and
487 changing a global preference (thus allowing e.g. random play to be
488 turned on or off). See the <tt>schedule-*</tt>
489 commands described in disorder(1).</p>
490
491 </div>
492
493 <h4>Random Track Choice</h4>
494
495 <div class=section>
496
497 <p>This has been completely rewritten to support new features:</p>
498
499 <ul>
500
501 <li>tracks in the recently-played list or in the queue are no longer
502 eligible for random choice.</li>
503
504 <li>there is a new <tt>weight</tt> track preference allowing for
505 non-uniform track selection. See disorder(1) for details.</li>
506
507 <li>there is a new configuration item <tt>replay_min</tt> defining
508 the minimum time before a played track can be picked at random.
509 The default is 8 hours (which matches the earlier behaviour).</li>
510
511 <li>recently added tracks are biased up; see <tt>new_bias</tt> and
512 <tt>new_bias_age</tt> in disorder_config(5).</li>
513
514 </ul>
515
516 </div>
517
518 <h4>Web Interface</h4>
519
520 <div class=section>
521
522 <p>This has been largely rewritten. The most immediate benefits are:</p>
523
524 <ul>
525
526 <li>the search page is integrated into the choose page, and
527 includes links to parent directories.</li>
528
529 <li>if you try to do something you have insufficient rights for,
530 instead of getting an error page or nothing happening, you are
531 redirected to the login page.</li>
532
533 </ul>
534
535 <p>Customizers should find their lives easier: the syntax is less onerous, it
536 is possible to define macros to avoid repetition, and the documentation is
537 less monolithic (see disorder.cgi(8) as a starting point).</p>
538
539 <p>Mail is now sent via the system sendmail program, though it remains
540 possible to use TCP to connect to an SMTP server. See <tt>sendmail</tt> and
541 <tt>smtp_server</tt> in disorder_config(5).</p>
542
543 <p>The web interface is now installed automatically. If you don't want it,
544 use <tt>./configure --without-cgi</tt>. If you want it in a non-default
545 location, or no location for it is detected, set <tt>cgidir</tt>
546 and <tt>httpdir</tt> on the <tt>./configure</tt> command line.</p>
547
548 </div>
549
550 </div>
551
552 <h3>Disobedience</h3>
553
554 <div class=section>
555
556 <p>There is now a new user management window. From here you can add and
557 remove users or modify their settings.</p>
558
559 <p>Relatedly, the server will only allow remote user management if you set
560 <tt>remote_userman</tt> to <tt>yes</tt>.</p>
561
562 </div>
563
564 <h3>Miscellaneous</h3>
565
566 <div class=section>
567
568 <p><tt>scripts/setup</tt> now honors command line options, and can
569 set up network play as well as the local default sound device.</p>
570
571 </div>
572
573 <h3>Bugs Fixed</h3>
574
575 <div class=section>
576
577 <table class=bugs>
578 <tr>
579 <th>ID</th>
580 <th>Description</th>
581 </tr>
582
583 <tr>
584 <td><a href="http://code.google.com/p/disorder/issues/detail?id=2">#2</a></td>
585 <td>Search results should link to directories</td>
586 </tr>
587
588 <tr>
589 <td><a href="http://code.google.com/p/disorder/issues/detail?id=6">#6</a></td>
590 <td>Schedule tracks for a particular time</td>
591 </tr>
592
593 <tr>
594 <td><a href="http://code.google.com/p/disorder/issues/detail?id=10">#10</a></td>
595 <td>Non-uniform track selection</td>
596 </tr>
597
598 <tr>
599 <td><a href="http://code.google.com/p/disorder/issues/detail?id=11">#11</a></td>
600 <td>Bias random selection to newly added tracks</td>
601 </tr>
602
603 <tr>
604 <td><a href="http://code.google.com/p/disorder/issues/detail?id=13">#13</a></td>
605 <td>Default encoding for debian setup scripts</td>
606 </tr>
607
608 <tr>
609 <td><a href="http://code.google.com/p/disorder/issues/detail?id=16">#16</a></td>
610 <td>Cookie expiry causes user to be silently logged out and not
611 subsequently redirected to login page</td>
612 </tr>
613
614 <tr>
615 <td><a href="http://code.google.com/p/disorder/issues/detail?id=20">#20</a></td>
616 <td>Broken aliasing rules</td>
617 </tr>
618
619 </table>
620
621 </div>
622
623 </div>
624
625 <h2>Changes up to version 3.0.2</h2>
626
627 <div class=section>
628
629 <p>Builds <tt>--without-server</tt> should work again.</p>
630
631 <p>The web interface is a bit more liberal in the cookie value
632 syntax it will accept.</p>
633
634 <p>Clients fail more gracefully if no password is available.</p>
635
636 </div>
637
638 <h2>Changes up to version 3.0.1</h2>
639
640 <div class=section>
641
642 <p>Debian upgrades from 2.0.x should now work better.</p>
643
644 </div>
645
646 <h2>Changes up to version 3.0</h2>
647
648 <div class=section>
649
650 <p><b>Important</b>! See <a
651 href="README.upgrades">README.upgrades</a> when upgrading.</p>
652
653 <h3>Platforms And Installation</h3>
654
655 <div class=section>
656
657 <p>Mac OS X and FreeBSD are somewhat supported. There is now a bash
658 script in <tt>scripts/setup</tt> which will automate the setup after
659 <tt>make install</tt>.</p>
660
661 </div>
662
663 <h3>Server</h3>
664
665 <div class=section>
666
667 <p>Users are now stored in the database rather than a configuration
668 file.</p>
669
670 <p>The server now has a built-in list of stopwords and players, so
671 only additions to these need be mentioned in the configuration file.</p>
672
673 <p>The default inter-track gap is now 0s.</p>
674
675 <p>How sound is played is now controlled via the new <tt>api</tt>
676 configuration command. This also controls how the volume is set,
677 which now works with ALSA as well as OSS.</p>
678
679 <p>A bug in the MP3 decoder was fixed (also in 2.0.4).</p>
680
681 </div>
682
683 <h3>Web Interface</h3>
684
685 <div class=section>
686
687 <p>The web interface now uses cookies to remember user identity, and
688 allows online registration of new users. Also it is no longer
689 necessary to manually specify the URL of the web interface (but you
690 can override it if you don't like the value it figures out).</p>
691
692 <p>It is possible to allow users to register via the web interface.</p>
693
694 <p>The web interface's browser support has been improved. It has
695 been tested with Firefox 2, Safari 3, Konqueror 3, Internet Explorer
696 7 and Opera 9.</p>
697
698 </div>
699
700 <h3>Disobedience</h3>
701
702 <div class=section>
703
704 <p>A bug which would cause a crash if you attempt to rearrange the
705 queue while no track was playing has been fixed. There is a new
706 'deselect all tracks' option, mirroring 'select all tracks.</p>
707
708 </div>
709
710 </div>
711
712 <!--
713 Local Variables:
714 fill-column:79
715 indent-tabs-mode:nil
716 End:
717 -->