1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
4 <title>DisOrder Change History</title>
5 <link rel=StyleSheet type="text/css" href="docs.css">
9 <h1>DisOrder Change History</h1>
11 <p>This file documents recent user-visible changes to <a
12 href="http://www.greenend.org.uk/rjk/disorder/">DisOrder</a>.</p>
14 <p><b>IMPORTANT</b>: you should read <a
15 href="README.upgrades.html">README.upgrades</a> before upgrading.</p>
17 <h2>Changes up to version 5.2</h2>
21 <h3>PulseAudio Support</h3>
25 <p>PulseAudio is now supported, if the support library is available at
26 build time. It is the default for client applications, reflecting its
27 widespread use in desktop environments.</p>
29 <p>Volume setting is not currently supported when PulseAudio is in
34 <h3>Changes To RTP Support</h3>
38 <p>Disobedience now has a menu to select the network playback API.</p>
40 <p><code>disorder-playrtp</code> now selects playback API using
41 a <code>--api</code> option. The old API-selection options remain
42 available but are deprecated and will be removed in the future.</p>
44 <p>RTP playback can now transmit to multiple unicast destinations, added
45 and removed on demand. This is controlled by the new <code>rtp_mode</code>
46 option. The motivating use case is a bridged network with high- and
47 low-capacity components. However it is may also be useful in a routed
48 network without multicast routing support.</p>
52 <h3>GStreamer support</h3>
56 <p>If it's detected at <tt>configure</tt> time, a new decoder
57 program <tt>disorder-gstdecode</tt> and a new tracklength
58 plugin <tt>tracklength-gstreamer</tt> are built. These use the GStreamer
59 library for filetype detection, audio decoding and sample-rate conversion,
60 among other features. Using these, DisOrder can play any audio file
61 supported by GStreamer.
63 <p>The decoder has a number of options for controlling the sample-rate and
64 audio format conversion, allowing various tradeoffs between quality and
65 processor time. (High-quality conversion can consume more processor time
66 than decoding, so this is potentially useful on very a small device such as
69 <p>The GStreamer decoder can also use ReplayGain information stored in
70 audio files' metadata to adjust playback volume, so that tracks with very
71 wide dynamic range don't sound really quiet in comparison. This
72 information can be added using tools such as <tt>mp3gain</tt>,
73 <tt>vorbisgain</tt>, or <tt>metaflac</tt>. This is turned on by default if
74 you use the decoder; you can choose between per-album or per-track
75 settings, or turn it off entirely, using command-line options.</p>
77 <p>The GStreamer decoder is not used by default, but it can be enabled
78 easily enough by dropping something like the following into the server
82 player *.flac execraw /usr/sbin/disorder-gstdecode -ralbum -f-8.0
83 player *.mp2 execraw /usr/sbin/disorder-gstdecode -ralbum -f-8.0
84 player *.mp3 execraw /usr/sbin/disorder-gstdecode -ralbum -f-8.0
85 player *.ogg execraw /usr/sbin/disorder-gstdecode -ralbum -f-8.0
86 player *.wav execraw /usr/sbin/disorder-gstdecode -ralbum -f-8.0
89 tracklength *.flac tracklength-gstreamer
90 tracklength *.mp2 tracklength-gstreamer
91 tracklength *.mp3 tracklength-gstreamer
92 tracklength *.ogg tracklength-gstreamer
93 tracklength *.wav tracklength-gstreamer
102 <li>The CGI program now checks user passwords even when it runs as the
103 main jukebox user(!).</li>
105 <li>DisObedience doesn't crash when search terms change under its
108 <li>The CGI program doesn't crash on some POST requests.
115 <h2>Changes up to version 5.1.1</h2>
124 <li><code>player</code> and <code>tracklength</code> can now be used
125 without arguments to clear the lists, as per the documentation.</li>
127 <li>Tracks without a player are forgotten upon rescan.</li>
129 <li>The speaker process avoids splitting frames.</li>
132 <p>Thanks to Mark Wooding and Joe Birr-Pixton.</p>
138 <h2>Changes up to version 5.1</h2>
142 <h3>Removable Device Support</h3>
146 <p>The server will now automatically initiate a rescan when a filesystem is
147 mounted or unmounted. (Use the <tt>mount_rescan</tt> option if you want to
148 suppress this behavior.)</p>
150 <p>The server takes care not to hold audio files open unnecessarily, so
151 that devices can be unmounted even if tracks from them are currently being
156 <h3>Disobedience</h3>
160 <p>You can now edit the <tt>required-tags</tt> and <tt>prohibited-tags</tt>
161 global preferences in Disobedience
162 (<a href="http://code.google.com/p/disorder/issues/detail?id=29">issue
165 <p>The “Manage users” option is now more reliably greyed out if
166 it will not work. This depends on a server change too, so it may still be
167 wrong if a new Disobedience is used against an old server.</p>
169 <p>A <tt>.desktop</tt> file is now shipped, making Disobedience visible as
170 an application in freedesktop.org-compliant systems.</p>
178 <p>The Debian package now includes a cronjob that backs up the database
179 daily. See <tt>/etc/cron.d/disorder</tt>. You can put settings
180 in <tt>/etc/default/disorder</tt> to turn this off or to control how long
181 the backups are kept for.</p>
183 <p>The <tt>disorder-dump -r</tt> option was broken.</p>
185 <p><tt>disorder-dump</tt> now gets permissions right automatically (<a
186 href="http://code.google.com/p/disorder/issues/detail?id=56">issue
195 <p>Unicode support has been upgraded to <a
196 href="http://www.unicode.org/versions/Unicode6.0.0/">Unicode
199 <p>Client programs no longer depend on libdb.</p>
201 <p>The following have been removed:</p>
205 <li>The <tt>allow</tt>, <tt>gap</tt>, <tt>lock</tt>, <tt>prefsync</tt>,
206 <tt>restrict</tt>, <tt>trust</tt> configuration commands. If they still
207 appear in your configuration file then the server will not start.</li>
209 <li>The <tt>columns</tt> web interface option. It will generate an
210 message in your error log but otherwise be ignored.</li>
212 <li>The <tt>--wait-for-device</tt> player option. If it still appears in
213 any player commands, they will not work.</li>
215 <li>Support for automatically importing pre-3.0 users.</li>
219 <p>Various minor bug fixes.</p>
225 <h2>Changes up to version 5.0.3</h2>
229 <p><b>Security</b>: Local connections can no longer create and delete users
230 unless they are properly authorized.</p>
234 <h2>Changes up to version 5.0.2</h2>
238 <p>The login form now indicates that a cookie will be set.</p>
242 <h2>Changes up to version 5.0.1</h2>
246 <h3>Disobedience</h3>
250 <p>The sense of the Control → Playing menu item was fixed.</p>
256 <h2>Changes up to version 5.0</h2>
264 <p>The <tt>device</tt> configuration option now works under OS X.
266 be specified either by UID or name. Fixes <a
267 href="http://code.google.com/p/disorder/issues/detail?id=27">Issue
270 <p>Gapless play should be more reliable, and playback latency over RTP
271 should be a bit lower. Note though that all the sound output code has
272 been reorganized and in some cases completely rewritten, so it's possible
273 that bugs may have been (re-)introduced. Decoding of scratches is also
274 initiated ahead of time, giving more reliable playback.</p>
276 <p>The <tt>command</tt> backend now (optionally) sends silence instead
277 of suspending writes when a pause occurs or no track is playing.</p>
279 <p>If <a href="http://www.mega-nerd.com/SRC/">libsamplerate</a> is
280 available at build time then that will be used instead of invoking
281 <a href="http://sox.sourceforge.net/">SoX</a>. SoX support will be
282 removed in a future version.</p>
284 <p>The libao plugin has been removed, because the plugin API is not
285 usable in libao 1.0.0.</p>
287 <p>Playlists are now supported. These allow a collection of tracks to be
288 prepared offline and played as a unit.</p>
292 <h3>Disobedience</h3>
296 <p>Multiple tracks can now be dragged in the queue in a single operation.
297 Furthermore, it is now possible to drag tracks from the
298 “Recent”, “Added” and “Choose” tabs
301 <p>Disobedience now supports playlist editing and has a compact mode,
302 available from the <b>Control</b> menu.</p>
304 <p>Disobedience has a <a href="disobedience/manual/index.html">new
309 <h3>Web Interface</h3>
313 <p>Confirmation URLs should be cleaner (and in particular not end
314 with punctuation). (Please see <a
315 href="README.upgrades.html">README.upgrades</a> for more about this.)</p>
323 <p>There is a new <tt>--command</tt> option which allows the RTP player
324 to send audio data to a user-chosen command instead of an audio API. See
325 the man page for details.</p>
327 <p>The <tt>--device</tt> option to <tt>disorder-playrtp</tt> now works
328 under OS X (as above).</p>
336 <p>IPv6 should now work. Network address specifications
337 (<tt>listen</tt>, <tt>connect</tt> etc) can now be prefixed with
338 <tt>-4</tt> or <tt>-6</tt> to force use
339 of IPv4 or IPv6, though normally this should not be needed.</p>
341 <p>Unicode support has been upgraded to <a
342 href="http://www.unicode.org/versions/Unicode5.1.0/">Unicode
345 <p>Various elements of the source code have been
361 <td><a href="http://code.google.com/p/disorder/issues/detail?id=22">#22</a></td>
362 <td>Background decoders interact badly with server reload</td>
366 <td><a href="http://code.google.com/p/disorder/issues/detail?id=27">#27</a></td>
367 <td>Mac DisOrder uses wrong sound device</td>
371 <td><a href="http://code.google.com/p/disorder/issues/detail?id=30">#30</a></td>
372 <td>mini disobedience interface</td>
376 <td><a href="http://code.google.com/p/disorder/issues/detail?id=32">#32</a></td>
377 <td>Excessively verbose log chatter on shutdown</td>
381 <td><a href="http://code.google.com/p/disorder/issues/detail?id=33">#33</a></td>
382 <td>(Some) plugins need -lm.</td>
386 <td><a href="http://code.google.com/p/disorder/issues/detail?id=39">#39</a></td>
387 <td>Double bind() non-multicast AF_INET</td>
391 <td><a href="http://code.google.com/p/disorder/issues/detail?id=40">#40</a></td>
392 <td>Missing stub function</td>
396 <td><a href="http://code.google.com/p/disorder/issues/detail?id=41">#41</a></td>
397 <td>Missing includes for timeval</td>
401 <td><a href="http://code.google.com/p/disorder/issues/detail?id=42">#42</a></td>
402 <td>syntax error in empeg_host section</td>
406 <td><a href="http://code.google.com/p/disorder/issues/detail?id=43">#43</a></td>
407 <td>decoder segfault with FLAC 1.2.1</td>
411 <td><a href="http://code.google.com/p/disorder/issues/detail?id=44">#44</a></td>
412 <td>gcc 4.3.2-1ubuntu12 SUYB patch</td>
416 <td><a href="http://code.google.com/p/disorder/issues/detail?id=45">#45</a></td>
417 <td>disobedience doesn't configure its back end</td>
421 <td><a href="http://code.google.com/p/disorder/issues/detail?id=46">#46</a></td>
422 <td>Sort search results in web interface</td>
426 <td><a href="http://code.google.com/p/disorder/issues/detail?id=48">#48</a></td>
427 <td>build-time dependency on <tt>oggdec</tt> removed</td>
431 <td><a href="http://code.google.com/p/disorder/issues/detail?id=49">#49</a></td>
432 <td>Disobedience's 'When' column gets out of date</td>
436 <td><a href="http://code.google.com/p/disorder/issues/detail?id=51">#51</a></td>
437 <td>Improved speaker process robustness</td>
442 <td>“found track in no collection” messages for scratches
443 are now suppressed</td>
448 <td>Disobedience would sometimes fail to notice when a track
449 started, leading to its display getting out of date.</td>
456 <h2>Changes up to version 4.3</h2>
460 <h3>Disobedience</h3>
464 <p>A bug was fixed in the calculation of how much of the track had
465 played. This would lead to the counter showing incorrect values in
466 various situations.</p>
468 <p>Disobedience's icons have been changed to larger, more colorful
469 ones. The SVG source is included if you want to fiddle with them.</p>
471 <p>“Select all” is now no longer available in the choose
472 tab. Instead there is a new “Select children” option which
473 selects the file children of a single subdirectory.</p>
481 <p>The selection bias for newly added tracks was reduced by half. You
482 can put it back to the old very neophilic value with
483 “<tt>new_bias 900000</tt>” in the config file.</p>
485 <p>It is now possible to ‘adopt’ randomly picked tracks.
486 Disobedience and the command-line client support this but the web
487 interface does not.</p>
489 <p>The default track name parsing was modified to handle filenames
490 generated by iTunes.</p>
494 <h3>Miscellaneous</h3>
498 <p><tt>disorderfm</tt> now preserves directory permissions.</p>
500 <p>DisOrder is now licensed under <a
501 href="http://www.gnu.org/licenses/gpl-3.0.html">GPL v3</a>. The main
502 goal is to prohibit <a
503 href="http://en.wikipedia.org/wiki/Tivoization">Tivoization</a>.</p>
505 <p>The build system will now automatically cope with Fink's broken GTK+
506 packages. There are a number of improvements to the Debian
509 <p>DisOrder now builds on 64-bit Linux systems.</p>
511 <p>There are various minor fixes.</p>
526 <td><a href="http://code.google.com/p/disorder/issues/detail?id=24">#24</a></td>
527 <td>Fails to build on ubuntu 8.10</td>
530 <td><a href="http://code.google.com/p/disorder/issues/detail?id=26">#26</a></td>
531 <td>Disobedience shows wrong track elapsed time after a pause</td>
538 <h2>Changes up to version 4.2</h2>
542 <h3>Disobedience</h3>
546 <p>The login window now has a 'remote' switch. If this is turned off
547 then Disobedience will connect to a local server. Formerly it would
548 always use TCP/IP.</p>
550 <p>The Delete and backspace keys will now remove tracks from the queue.
551 Escape will now dismiss the properties, users or login windows and return
552 now works in the login and properties windows.</p>
556 <h3>Documentation</h3>
560 <p>Track and global preferences are now described in a new
561 <b>disorder_preferences</b>(5) man page.</p>
576 <td><a href="http://code.google.com/p/disorder/issues/detail?id=21">#21</a></td>
577 <td>CGI should use PATH_INFO more sensibly</td>
585 <h2>Changes up to version 4.1.1</h2>
589 <p>Disobedience's “Login” window now works when you are logged
594 <h2>Changes up to version 4.1</h2>
598 <h3>Disobedience</h3>
602 <p>Disobedience has been largely rewritten:</p>
606 <li>All the tabs now use native GTK+ list/tree widgets, resulting in
607 greater speed in some cases and more consistency with other GTK+
610 <li>You can now use type-ahead find in the choose tab. The initiation
611 of a search is delayed slightly to avoid lots of updates when you're
612 half way through entering search terms.</li>
614 <li>The choose tab now shows track lengths.</li>
616 <li>Many buttons are now more reliably made insensitive when they can't
619 <li>You can now play tracks off the recent tab.</li>
623 <p>Disobedience attempts to cope with servers from older versions, up to
624 a point, but this is not well tested and it's best to keep the server
625 fully up to date.</p>
633 <p>When a track shares a directory with its alias, the real track name is
634 now returned instead of the alias (the opposite way round to the previous
640 <h2>Changes up to version 4.0.2</h2>
644 <p>Corrected web browser linked from Disobedience.</p>
648 <h2>Changes up to version 4.0.1</h2>
652 <p>Libtool and Automake now install the CGI correctly. As part of this,
653 <tt>cgidir</tt> has been renamed to <tt>cgiexecdir</tt>. The configure
654 script will report an error if you try to use the old name.</p>
658 <h2>Changes up to version 4.0</h2>
666 <p>The <tt>gap</tt> directive will no longer work. It could be
667 restored if there is real demand.</p>
669 <h4>Event Scheduling</h4>
673 <p>It is now possible to schedule events to occur in the future.
674 Currently the supported actions are playing a specific track, and
675 changing a global preference (thus allowing e.g. random play to be
676 turned on or off). See the <tt>schedule-*</tt>
677 commands described in disorder(1).</p>
681 <h4>Random Track Choice</h4>
685 <p>This has been completely rewritten to support new features:</p>
689 <li>tracks in the recently-played list or in the queue are no longer
690 eligible for random choice.</li>
692 <li>there is a new <tt>weight</tt> track preference allowing for
693 non-uniform track selection. See disorder(1) for details.</li>
695 <li>there is a new configuration item <tt>replay_min</tt> defining
696 the minimum time before a played track can be picked at random.
697 The default is 8 hours (which matches the earlier behaviour).</li>
699 <li>recently added tracks are biased up; see <tt>new_bias</tt> and
700 <tt>new_bias_age</tt> in disorder_config(5).</li>
706 <h4>Web Interface</h4>
710 <p>This has been largely rewritten. The most immediate benefits are:</p>
714 <li>the search page is integrated into the choose page, and
715 includes links to parent directories.</li>
717 <li>if you try to do something you have insufficient rights for,
718 instead of getting an error page or nothing happening, you are
719 redirected to the login page.</li>
723 <p>Customizers should find their lives easier: the syntax is less onerous, it
724 is possible to define macros to avoid repetition, and the documentation is
725 less monolithic (see disorder.cgi(8) as a starting point).</p>
727 <p>Mail is now sent via the system sendmail program, though it remains
728 possible to use TCP to connect to an SMTP server. See <tt>sendmail</tt> and
729 <tt>smtp_server</tt> in disorder_config(5).</p>
731 <p>The web interface is now installed automatically. If you don't want it,
732 use <tt>./configure --without-cgi</tt>. If you want it in a non-default
733 location, or no location for it is detected, set <tt>cgidir</tt>
734 and <tt>httpdir</tt> on the <tt>./configure</tt> command line.</p>
740 <h3>Disobedience</h3>
744 <p>There is now a new user management window. From here you can add and
745 remove users or modify their settings.</p>
747 <p>Relatedly, the server will only allow remote user management if you set
748 <tt>remote_userman</tt> to <tt>yes</tt>.</p>
752 <h3>Miscellaneous</h3>
756 <p><tt>scripts/setup</tt> now honors command line options, and can
757 set up network play as well as the local default sound device.</p>
772 <td><a href="http://code.google.com/p/disorder/issues/detail?id=2">#2</a></td>
773 <td>Search results should link to directories</td>
777 <td><a href="http://code.google.com/p/disorder/issues/detail?id=6">#6</a></td>
778 <td>Schedule tracks for a particular time</td>
782 <td><a href="http://code.google.com/p/disorder/issues/detail?id=10">#10</a></td>
783 <td>Non-uniform track selection</td>
787 <td><a href="http://code.google.com/p/disorder/issues/detail?id=11">#11</a></td>
788 <td>Bias random selection to newly added tracks</td>
792 <td><a href="http://code.google.com/p/disorder/issues/detail?id=13">#13</a></td>
793 <td>Default encoding for debian setup scripts</td>
797 <td><a href="http://code.google.com/p/disorder/issues/detail?id=16">#16</a></td>
798 <td>Cookie expiry causes user to be silently logged out and not
799 subsequently redirected to login page</td>
803 <td><a href="http://code.google.com/p/disorder/issues/detail?id=20">#20</a></td>
804 <td>Broken aliasing rules</td>
813 <h2>Changes up to version 3.0.2</h2>
817 <p>Builds <tt>--without-server</tt> should work again.</p>
819 <p>The web interface is a bit more liberal in the cookie value
820 syntax it will accept.</p>
822 <p>Clients fail more gracefully if no password is available.</p>
826 <h2>Changes up to version 3.0.1</h2>
830 <p>Debian upgrades from 2.0.x should now work better.</p>
834 <h2>Changes up to version 3.0</h2>
838 <p><b>Important</b>! See <a
839 href="README.upgrades.html">README.upgrades</a> when upgrading.</p>
841 <h3>Platforms And Installation</h3>
845 <p>Mac OS X and FreeBSD are somewhat supported. There is now a bash
846 script in <tt>scripts/setup</tt> which will automate the setup after
847 <tt>make install</tt>.</p>
855 <p>Users are now stored in the database rather than a configuration
858 <p>The server now has a built-in list of stopwords and players, so
859 only additions to these need be mentioned in the configuration file.</p>
861 <p>The default inter-track gap is now 0s.</p>
863 <p>How sound is played is now controlled via the new <tt>api</tt>
864 configuration command. This also controls how the volume is set,
865 which now works with ALSA as well as OSS.</p>
867 <p>A bug in the MP3 decoder was fixed (also in 2.0.4).</p>
871 <h3>Web Interface</h3>
875 <p>The web interface now uses cookies to remember user identity, and
876 allows online registration of new users. Also it is no longer
877 necessary to manually specify the URL of the web interface (but you
878 can override it if you don't like the value it figures out).</p>
880 <p>It is possible to allow users to register via the web interface.</p>
882 <p>The web interface's browser support has been improved. It has
883 been tested with Firefox 2, Safari 3, Konqueror 3, Internet Explorer
888 <h3>Disobedience</h3>
892 <p>A bug which would cause a crash if you attempt to rearrange the
893 queue while no track was playing has been fixed. There is a new
894 'deselect all tracks' option, mirroring 'select all tracks.</p>