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