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