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