disorder-speaker now treats read errors as equivalent to EOF (apart
[disorder] / CHANGES.html
CommitLineData
b0a578cb
RK
1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2<html>
3<head>
4<title>DisOrder Change History</title>
5<style type="text/css">
6body {
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
15div.section {
16 margin-left:1em
17}
18
19h1 {
20 background-color: #e0ffe0;
21 font-family: helvetica,sans-serif;
22 padding: 0.2em
23}
24
25h2 {
26 background-color: #e0ffe0;
27 font-family: helvetica,sans-serif;
28 padding: 0.2em
29}
30
31h3 {
32 background-color: #f0f0f0;
33 font-family: helvetica,sans-serif;
34 padding: 0.2em
35}
36
37h4 {
38 font-family: helvetica,sans-serif
39}
40
41table.bugs {
37e94d5c
RK
42 width: 100%;
43 font-size: 12pt;
44 border-collapse: collapse;
45 border:1px
b0a578cb
RK
46}
47
48table.bugs th {
37e94d5c
RK
49 text-align: left;
50 border: 1px solid black;
51 background-color: black;
52 color: white
53}
54
55table.bugs td {
56 border: 1px solid
b0a578cb
RK
57}
58
59span.command {
60 font-family: monospace
61}
62</style>
63</head>
64
65<body>
66<h1>DisOrder Change History</h1>
67
d8b95785
RK
68<p>This file documents recent user-visible changes to <a
69 href="http://www.greenend.org.uk/rjk/disorder/">DisOrder</a>.</p>
70
64360021 71<h2>Changes up to version 5.0</h2>
f5fd9a6b
RK
72
73 <div class=section>
74
f207f710
RK
75 <h3>Server</h3>
76
f5fd9a6b
RK
77 <div class=section>
78
fe33cfc0 79 <p>The <tt>device</tt> configuration option now works under OS X.
7cd4dd21 80 Devices may
f207f710 81 be specified either by UID or name. Fixes <a
f5fd9a6b
RK
82 href="http://code.google.com/p/disorder/issues/detail?id=27">Issue
83 27</a>.</p>
f207f710 84
f71fc3ab 85 <p>Gapless play should be more reliable, and playback latency over RTP
6762ac8a 86 should be a bit lower. Note though that all the sound output code has
f71fc3ab 87 been reorganized and in some cases completely rewritten, so it's possible
900fa0b8
RK
88 that bugs may have been (re-)introduced. Decoding of scratches is also
89 initiated ahead of time, giving more reliable playback.</p>
7cd4dd21
RK
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>
c3feb35b
RK
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
317dc3e8
RK
96 <a href="http://sox.sourceforge.net/">SoX</a>. SoX support will be
97 removed in a future version.</p>
c3feb35b 98
79ab6bd2
RK
99 <p>Playlists are now supported. These allow a collection of tracks to be
100 prepared offline and played as a unit.</p>
101
7cd4dd21
RK
102 </div>
103
6a7eb118
RK
104 <h3>Disobedience</h3>
105
106 <div class=section>
107
69c456f3
RK
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>
6a7eb118 112
c2f51940
RK
113 <p>Disobedience now supports playlist editing and has a compact mode,
114 available from the <b>Control</b> menu.</p>
79ab6bd2 115
67b1beae
RK
116 <p>Disobedience has a <a href="disobedience/manual/index.html">new
117 manual</a>.</p>
118
6a7eb118
RK
119 </div>
120
7cd4dd21
RK
121 <h3>Web Interface</h3>
122
123 <div class=section>
53710d44 124
7cd4dd21
RK
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>
533272be 128
f207f710
RK
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>
f5fd9a6b
RK
141
142 </div>
7cd4dd21
RK
143
144 <h3>General</h3>
f5fd9a6b 145
7cd4dd21
RK
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
2cb9bc5f
RK
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
7cd4dd21
RK
157 <p>Various elements of the source code have been
158 rationalized.</p>
159
160 </div>
161
f5fd9a6b
RK
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>
417ef7de
RK
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
f5fd9a6b
RK
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
7cd4dd21 182 <tr>
548c9cba
RK
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>
bbaed9ec
RK
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>
7cd4dd21
RK
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>
6762ac8a
RK
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>
93379b3d
RK
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>
6762ac8a
RK
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>
fa667301
RK
231
232 <tr>
d53ef367
RK
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>
fa667301
RK
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
e03df0a5
RK
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
900fa0b8 247 <tr>
de38ab9b
RK
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>
900fa0b8
RK
253 <td>(none)</td>
254 <td>&ldquo;found track in no collection&rdquo; messages for scratches
255 are now suppressed</td>
256 </tr>
257
37e94d5c
RK
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
f5fd9a6b 264 </table>
f5fd9a6b
RK
265 </div>
266 </div>
267
a0e78d96 268<h2>Changes up to version 4.3</h2>
d8b95785
RK
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
e02f9807
RK
277 played. This would lead to the counter showing incorrect values in
278 various situations.</p>
d8b95785
RK
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
a0e78d96
RK
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
d8b95785
RK
287 </div>
288
6151ae7e
RK
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
ff45af7c
RK
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
e02f9807
RK
301 <p>The default track name parsing was modified to handle filenames
302 generated by iTunes.</p>
303
6151ae7e
RK
304 </div>
305
10a6c925 306 <h3>Miscellaneous</h3>
d8b95785
RK
307
308 <div class=section>
309
10a6c925
RK
310 <p><tt>disorderfm</tt> now preserves directory permissions.</p>
311
e7eb3a27
RK
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
d8b95785 317 <p>The build system will now automatically cope with Fink's broken GTK+
e02f9807
RK
318 packages. There are a number of improvements to the Debian
319 packaging.</p>
d8b95785 320
74cfbeaa
RK
321 <p>DisOrder now builds on 64-bit Linux systems.</p>
322
e02f9807 323 <p>There are various minor fixes.</p>
d8b95785
RK
324
325 </div>
326
e02f9807
RK
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>
d8b95785 348 </div>
b0a578cb 349
eb2a1fe9
RK
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>
cc5b0a8e
RK
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>
eb2a1fe9
RK
394</div>
395
396
68210888
RK
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
452ad6ba
RK
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>
30f2f8c9
RK
430
431 <li>You can now play tracks off the recent tab.</li>
432
452ad6ba
RK
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
32918782
RK
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
f03d4184
RK
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
0ba75c7f 470<h2>Changes up to version 4.0</h2>
b0a578cb
RK
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
2eee4b0c
RK
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>
4cbafe13 542
64ac73bb
RK
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>
2eee4b0c 547
b0a578cb
RK
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<!--
713Local Variables:
714fill-column:79
4cbafe13 715indent-tabs-mode:nil
b0a578cb
RK
716End:
717-->