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