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