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