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