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