chiark / gitweb /
851fa3458dcc58f53bc30e1b39ddab058089876b
[disorder] / CHANGES.html
1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2 <html>
3 <head>
4 <title>DisOrder Change History</title>
5 <style type="text/css">
6 body {
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
15 div.section {
16   margin-left:1em
17 }
18
19 h1 {
20   background-color: #e0ffe0;
21   font-family: helvetica,sans-serif;
22   padding: 0.2em
23 }
24
25 h2 {
26   background-color: #e0ffe0;
27   font-family: helvetica,sans-serif;
28   padding: 0.2em
29 }
30
31 h3 {
32   background-color: #f0f0f0;
33   font-family: helvetica,sans-serif;
34   padding: 0.2em
35 }
36
37 h4 {
38   font-family: helvetica,sans-serif
39 }
40
41 table.bugs {
42   width: 100%
43 }
44
45 table.bugs th {
46   text-align: left
47 }
48
49 span.command {
50   font-family: monospace
51 }
52 </style>
53 </head>
54
55 <body>
56 <h1>DisOrder Change History</h1>
57
58 <p>This file documents recent user-visible changes to <a
59  href="http://www.greenend.org.uk/rjk/disorder/">DisOrder</a>.</p>
60
61 <h2>Changes up to version 4.4</h2>
62
63   <div class=section>
64   
65     <h3>Server</h3>
66  
67     <div class=section>
68
69       <p>The <tt>device</tt> configuration option now works under OS X.
70       Devices may
71       be specified either by UID or name.  Fixes <a
72        href="http://code.google.com/p/disorder/issues/detail?id=27">Issue
73       27</a>.</p>
74
75       <p>Gapless play should be more reliable, and playback latency over RTP
76       should be a bit lower.  Note though that all the sound output code has
77       been reorganized and in some cases completely rewritten, so it's possible
78       that bugs may have been (re-)introduced.</p>
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>
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
87     </div>
88       
89     <h3>Disobedience</h3>
90
91     <div class=section>
92
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>
97
98     </div>
99
100     <h3>Web Interface</h3>
101  
102     <div class=section>
103
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       
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>
120         
121     </div>
122       
123     <h3>General</h3>
124
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
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
136       <p>Various elements of the source code have been
137       rationalized.</p>
138       
139     </div>
140     
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
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>
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
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
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>
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
201         
202       </table>
203       
204     </div>
205   </div>
206
207 <h2>Changes up to version 4.3</h2>
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
216         played.  This would lead to the counter showing incorrect values in
217         various situations.</p>
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
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
226       </div>
227
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
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
240         <p>The default track name parsing was modified to handle filenames
241         generated by iTunes.</p>
242         
243       </div>
244
245     <h3>Miscellaneous</h3>
246
247       <div class=section>
248
249         <p><tt>disorderfm</tt> now preserves directory permissions.</p>
250
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
256         <p>The build system will now automatically cope with Fink's broken GTK+
257         packages.  There are a number of improvements to the Debian
258         packaging.</p>
259
260         <p>DisOrder now builds on 64-bit Linux systems.</p>
261
262         <p>There are various minor fixes.</p>
263
264       </div>
265
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>
287   </div>
288
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>
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>
333 </div>
334
335
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
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>
369
370         <li>You can now play tracks off the recent tab.</li>
371         
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
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
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
409 <h2>Changes up to version 4.0</h2>
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
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>
481
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>
486   
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 <!--
652 Local Variables:
653 fill-column:79
654 indent-tabs-mode:nil
655 End:
656 -->