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