chiark / gitweb /
When shutting down, kill -rescan and wait for it to finish. If -rescan outlives
[disorder] / CHANGES
1 See ChangeLog.d/* for detailed revision history.
2
3 * Changes up to version 2.1
4
5 ** Server
6
7 Users are now stored in the database rather than a configuration file.
8
9 The server now has a built-in list of stopwords and players, so only
10 additions to these need be mentioned in the configuration file.
11
12 The default inter-track gap is now 0s.
13
14 How sound is played is now controlled via the new 'api' configuration
15 command.  This also controls how the volume is set, which now works with
16 ALSA as well as OSS.
17
18 ** Web Interface
19
20 The web interface now uses cookies to remember user identity, and allows
21 online registration of new users.  Also it is no longer necessary to
22 manually specify the URL of the web interface (but you can override it
23 if you don't like the value it figures out).
24
25 It is possibe to allow users to register via the web interface.
26
27 The web interface's browser support has been improved.  It has been
28 tested with Firefox 2, Safari 3, Konqueror 3, Internet Explorer 7 and
29 Opera 9.
30
31 * Changes up to version 2.0
32
33 ** General
34
35 Tracks can now have tags associated with them.  See tags in disorder(1)
36 or the preferences documentation for the web interface or Disobedience.
37
38 The search facility knows how to limit results by tag (see search
39 documentation for any interface) as well as by word search.  It is
40 possible to limit random play by tag (see required-tags and
41 prohibited-tags in disorder_config(5)).
42
43 Unicode support is improved.  Case-folding and word breaking now follows
44 the rules given in the Unicode standard (with a bit of tailoring in the
45 latte case).
46
47 ** Disobedience
48
49 There is a new client, 'Disobedience', that depends on the GTK+ library.
50 Feedback on the interface would be very welcome.
51
52 ** Web Interface
53
54 The "New" screen display tracks recently added to the database.  From
55 here they can be played or their preferences changed.
56
57 Long track names are truncated so they fit better on the screen.  Hover
58 for the full name.
59
60 ** Network Play
61
62 DisOrder can broadcast audio over a network, allowing it to be played on
63 multiple client machines.  See README.streams for details.
64
65 ** Server
66
67 Slow file lookups are cached in the server.  This should help
68 installations with large collections and/or slow platforms.
69
70 The 'enabled' and 'random_enabled' configuration options are now gone.
71 Instead the state survives from one run of the server to the next.
72 'disable now' is gone as well - if you want to emulate it disable
73 playing and then scratch the current track.
74
75 The 'pick' plugin has been abolished.  All the logic formerly done there
76 is now built into the server, where it can be done much more
77 efficiently.
78
79 'tracklength' plugins must be explicitly specified.
80
81 A bug where removing a collection (from the configuration) could cause a
82 crash when random play was enabled has been fixed.
83
84 A new configuration option 'queue_pad' allows the number of random
85 tracks kept on the queue to be controlled.
86
87 There is a new utility disorder-decode which can decode OGG, MP3, WAV
88 and FLAC.  The example config file uses it.
89
90 Database statistics are computed in a subprocess so that the main server
91 (and all clients) are not blocked for the duration.
92
93 ** disorderfm
94
95 There is a new command line tool called 'disorderfm' which is designed
96 for filename translation on (for instance) digital audio repositories.
97 It is not yet feature-complete.  See its man page for additional
98 details.
99
100 ** Build And Configuration
101
102 You can control which components are built with new --with options.  See
103 README.
104
105 options.transform and the 'transform' web option have gone, replaced
106 with a 'transform' configuration command.  Both this and 'namepart' are
107 now optional.
108
109 ** Thanks
110
111 Ross Younger, Colin Watson, Michael Stevens and Mark Wooding all
112 contributed in some way to this release.
113
114 * Changes up to version 1.5.1
115
116 ** Web Interface
117
118 Correct regexp for non-alpha tracks.
119
120 * Changes up to version 1.5
121
122 ** Web Interface
123
124 Regexp-based filtering of tracks (for instance as used by the initial
125 'Choose' page) now does the regexp matching in the server, limiting the
126 amount of data transferred to the web interface only to be discarded.
127
128 ** Client
129
130 Regexp-base filtering of tracks is now available to the command line
131 client.
132
133 ** Server
134
135 New server_nice, speaker_nice and rescan_nice configuration options
136 allow independent control of process priorities.
137
138 Scratches are now attributed to the user who requested them.
139
140 Bugs fixed:
141   A file descriptor was leaked for each track played.
142   The amount of a track played so far was not reported.
143   The speaker process could crash on underrun.
144   The server would crash if you paused a non-pause capable track.
145   Regexp matching in the file and directory list commands was not
146   reliable.
147   Handling of variable-argument commands in the client was broken.
148
149 * Changes up to version 1.4
150
151 ** General
152
153 Raw format players are now supported.  See README.upgrades and
154 README.raw for details.  This allows pausing and eliminating the
155 inter-track gap.
156
157 Pausing is also supported with suitably modified standalone player
158 plugins, though none of the supplied ones are capable of this.
159
160 When random play is enabled the randomly picked track now appears in the
161 queue, and can be moved around the queue, removed from it, etc.
162
163 ** Web Interface
164
165 Switches (random play, pause, ...) are now presented as a
166 fixed-appearance switch with an adjacent state indicator.
167
168 The 'Manage' screen has new buttons to move tracks to the head or tail
169 of the queue.
170
171 You can now edit the preferences for all the tracks in an album in a
172 single screen, rather than having to visit each separately.  For the
173 time being the raw preferences editing has gone; it can be reintroduced
174 on some form if there is demand.  (You can still edit raw preferences
175 from the command line.)
176
177 Labels are now documented in options.labels rather than
178 disorder_config(5).
179
180 ** Server
181
182 If you tried to start up on any empty database with random play enabled
183 the server would exit with an error.
184
185 The server no longer risks failing if you strace its player
186 subprocesses.
187
188 It was possible for the server to hang when a 'reconfigure' command was
189 issued.  This should no longer be the case.
190
191 The default signal to forcibly terminate players is now SIGKILL.
192
193 ** Plugins
194
195 Plugins must now declare a type word.  This allows them to document
196 whether they are a standalone player or a raw-format player, and whether
197 they support pausing.  They can also arrange to get setup and cleanup
198 calls in the main server.  See disorder(3) for more details.
199
200 * Changes up to version 1.3
201
202 ** Dependencies
203
204 Berkeley DB 4.2 is no longer supported.  Use 4.3.
205
206 ** Client
207
208 There is a new 'authorize' command to simplify the addition of local
209 users.  Please report successes as well as failures.
210
211 There is a new 'resolve' command to return the real track name behind an
212 alias.
213
214 The 'rescan' command no longer takes an argument.
215
216 ** Server
217
218 The track database code has been largely rewritten to improve
219 maintainability.
220
221 There is a new 'lock' directive.  By default the server uses a lockfile
222 to prevent multiple copies of itself running simultaneously; this can be
223 inhibited e.g. if you are using a filesystem that does not support
224 locking and are confident you can prevent concurrent running yourself.
225
226 Aliases for track names, constructed from trackname_display_
227 preferences, now appear in the virtual filesystem.  
228
229 The server now executes a subprocess for the rescan operation.  It also
230 runs a separate deadlock manager.
231
232 Standard output and standard error from subprocesses are now logged.
233 This is handy if you need to figure out why a player failed unexpectedly
234 but might lead to huge log files if you have needlessly verbose players.
235
236 ** Web Interface
237
238 Enable/disable buttons are now colored to reflect current state.
239
240 Entering numeric volume values (rather than clicking on the arrows) now
241 works.
242
243 Connection errors are reported more gracefuly.
244
245 ** Plugins
246
247 Scanner plugins are now always invoked in a subprocess.
248
249 disorder_track_count() and disorder_track_getn() are no longer
250 available.  Instead use disorder_track_random().
251
252 Plugins are now opened with RTLD_NOW, so link errors are detected
253 immediately.
254
255 ** Tools
256
257 disorder-dump now insists on the input/output file being a named regular
258 file, rather than using stdin or stdout.
259
260 ** Other
261
262 Some missing files have been added, and some notes added regarding
263 getting text encoding right.
264
265 * Changes up to version 1.2
266
267 See README.upgrades when upgrading to this version.
268
269 ** Bugs Fixed
270
271 Avoid accumulating overlarge recently played list.
272
273 When the server was stopped, the currently playing track would not be
274 added to the recently played list.  This has been fixed.
275
276 Reloading the 'volume' page no longer repeats the last volume-changing
277 action.
278
279 The search facility now works properly for multiple hits within a single
280 artist or album.
281
282 ** Server
283
284 New namepart directive replaces web interface's trackname-part.  There
285 are associated changes to the protocol and clients.
286
287 The number of database queries per candidate match required when
288 searching has been reduced.
289
290 The operator can control the signal used to scratch playing tracks.  The
291 default has been changed to SIGINT from SIGKILL.
292
293 The 'log' command now provides a formalised event log, rather than raw
294 access to the server's ordinary log output.
295
296 ** Web Interface Changes
297
298 *** Choosing Tracks
299
300 When picking a track the client now stays on the same screen rather than
301 redirecting back to the 'Playing' screen.  So that the user gets
302 feedback from their action, playing and queued tracks are now marked as
303 such in the track picking screen.
304
305 It is possible to revert to the old behaviour by removing the back=
306 argument from the choose.html and search.html templates (and optionally
307 the trackstate lines).
308
309 *** Search
310
311 Non-ASCII characters are now properly supported in search terms.
312
313 *** Syntax
314
315 The template syntax has been changed slightly to ignore whitespace in
316 certain places.
317
318 *** Miscellaneous
319
320 Some formerly textual buttons are now replaced by images (with ALT text
321 reflecting the old value).  The stylesheet is now a .css file (installed
322 in the same place as the images) rather than being embedded into every
323 template.
324
325 Artist and album names in the playing and recently-played lists are now
326 links to the corresponding directory.
327
328 More functions are now available from the 'manage' screen.
329
330 The menus are now (by default) across the top of the screen instead of
331 down the side.  Set the 'menu' label to 'sidebar' to restore the old
332 appearance.  'Volume' is not present in this new menu, use 'Manage'
333 instead (or edit the template).
334
335 ** tkdisorder
336
337 tkdisorder now displays artist, album and title in the queue and
338 recently played widgets, rather than just the title (as formerly).
339
340 * Changes up to version 1.1
341
342 ** Bugs Fixed
343
344 Corrected various problems with UTF-8 parsing.
345
346 In the web interface, "The Beatles" (etc) are now grouped under 'B' not
347 'T' when grouping tracks by initial letter.
348
349 ** Server
350
351 The list of recently played tracks is now preserved across server
352 restarts.
353
354 Track IDs are more compact.
355
356 Versions of libdb before 4.2 are no longer supported.  4.2 and 4.3 both
357 work now.  4.2 support will be removed in some future release.
358
359 Prehistoric backwards-compatibility logic removed.  Only affects people
360 upgrading from long before 1.0 (who should upgrade to 1.0 and then to
361 1.1.)
362
363 ** Command Line
364
365 Tracks can be moved in the queue from the command line.
366
367 'disorder queue' now reports track IDs.
368
369 $pkgdatadir/completion.bash provides tab completion over commands and
370 options.
371
372 ** Web Interface
373
374 New 'cooked' preferences interface saves users having to know arcane
375 details of trackname preferences and so on.  Non-ASCII characters are
376 now properly supported in this context.
377
378 CGI arguments to the web interface are now checked for UTF-8 compliance.
379
380 Local Variables:
381 mode:outline
382 fill-column:72
383 End: