robustness fixes for the random selector
[paraslash.git] / NEWS
1 NEWS
2 ====
3
4 ------------------------------------------------
5 0.2.14 (to be announced) "transient singularity"
6 ------------------------------------------------
7
8 The only major enhancement of this version is the osx writer which completes
9 the Mac OS Port and was originally planned already for 0.2.13 but had to wait
10 until now for reasons beyond the scope of this changelog entry.
11
12         - new output plugin for Mac Os: the osx writer
13         - rename configure command line options from --enable-xxx-headers to
14           --with-xxx-headers and  --enable-xxx-libs to --with-xxx-libs
15         - configure: new command line options: --with-mad-headers
16           and --with-mad-libs
17         - some robustness fixes
18         - dymamic audio format recognition for audiod
19
20 ---------------------------------------
21 0.2.13 (2006-07-14) "sonic convolution"
22 ---------------------------------------
23
24 A bunch of new features and core changes.
25
26         - the new paraslash scheduler, short and sweet.
27         - Support for m4a/mp4 files via the new aac audio format
28           handler/filter (requires libfaad).
29         - each writer has its own command line parser, just like
30           para_recv and para_filter.
31         - para_client and para_audioc use the error subsystem
32         - writers are integrated in para_audiod (currently linux-only)
33         - para_client is integrated in para_audiod
34         - random/playlist selector: improved info strings
35         - new audiod commands: tasks, kill
36         - update to libortp-0.10.1
37         - para_fade: wake time defaults to 8 hours from now
38         - update to autoconf-2.60
39
40
41 ------------------------------------------
42 0.2.12 (2006-05-12) "oriented abstraction"
43 ------------------------------------------
44
45 Many user-visible changes in this release and lots of new
46 features:
47
48
49         - the new optional dccp sender/receiver. It uses the datagram
50           congestion control protocol. You'll need a fairly new kernel
51           for this.
52         - paraslash works on Mac OS X (thanks to Gerd Becker)
53         - para_play renamed to para_write
54         - modular output plugin design (writers) for para_write
55         - new file_writer output plugin for para_write
56         - compress filter speed improvements
57         - update to libortp-0.9.1
58         - update to gengetopt-2.17rc
59         - para_client no longer depends on libreadline (as the
60           code for the interactive mode was removed).
61         - gcc-2-95 is no longer a supported compiler. It may still
62           work, but it gets no more testing.
63         - the tarball no longer contains the screenshot images which
64           reduces its size quite a bit.
65         - configure: new command line options: --enable-mysql-headers
66           and --enable-mysql-libs
67
68 ------------------------------------
69 0.2.11 (2006-03-11) "atomic duality"
70 ------------------------------------
71
72 Here it is, the first paraslash release developed with git. There
73 are fairly many user-visible changes in this release. As two out of
74 the three "database tools" of paraslash don't use a database at all,
75 they are now called "audio file selectors" instead.
76
77
78         - the cdt command (change database tool) becomes chs (change
79           selector)
80         - no more colon separators: The syntax of some options of
81           para_audiod and para_filter have changed. Use --help for
82           more info (and some examples).
83         - update to gengetopt-2.16 (thanks to Lorenzo Bettini)
84         - switch from cvs to git (should've done that earlier)
85         - the new ipc subsystem
86         - new audio file selector: playlist
87         - para_server: the dopey selector is now called "random",
88           and is the default selector. Use the --selector option to
89           choose another selector at startup, or the chs command to
90           change the selector at runtime.
91         - X86_64 fixes (thanks to Steffen Klassert)
92         - para_play fixes
93
94
95 --------------------------------------
96 0.2.10 (2006-02-17) "cyclic attractor"
97 --------------------------------------
98
99 Huge documentation update, a scrollable window for para_gui, ortp
100 improvements, and of course many small fixes not mentioned here.
101 The diffstat below is rather misleading as most insertions are due
102 to the new source documentation.
103
104         - autoconf cleanup
105         - para_server also uses the new error subsystem
106         - lots of new documentation (UTSL)
107         - gui improvements:
108                 - keysyms for cursor keys and for next/previous page keys
109                 - scrollable output window
110                 - new internal commands: scroll up/down, page up/down
111                 - fix color of command output.
112         - ortp: the --chunk_time and --header flags are no longer needed
113         for para_recv/para_audiod as this information is now encoded in
114         each rtp packet sent by para_server.
115
116
117 -------------------------------------------
118 0.2.9 (2006-01-24) "progressive turbulence"
119 -------------------------------------------
120
121 Internal audiod receivers/filters, the new error subsystem and
122 a lot of small improvements.
123
124         - para_recv and para_filter are integrated into the para_audiod
125           binary, i.e. audiod no longer spawns a new process for
126           each receiver/filter. As para_recv and para_filter might be
127           useful as standalone programs, they still get built (linked
128           against the same object files that are also used for audiod).
129         - further ortp timing improvements should reduce the CPU usage
130           of the ortp receiver.
131         - improved audio grabbing. The 'grab' command of para_audiod
132           has its own set of command line options. Read the output of
133           "para_audioc help grab" for more info.
134         - oggdec: configurable input prebuffer size.
135         - the new error subsystem gives better error diagnostics
136           and reduces code size.
137
138
139 -----------------------------------------
140 0.2.8 (2006-01-02) "dynamic accumulation"
141 -----------------------------------------
142
143 The new modular filter design and the para_play-hangs bugfix.
144
145         - new executable: para_filter. It combines para_mp3dec,
146           para_oggdec and para_compress. It also adds a further filter
147           type, wav, that just inserts a wave header at the desired point
148           of the filter chain. All 'piping' is done in-memory (i.e. no
149           read/write operations are used).
150         - para_play: fix a stupid bug that caused it to hang under
151           certain circumstances.
152
153
154 -------------------------------------------
155 0.2.7 (2006-12-27) "transparent invariance"
156 -------------------------------------------
157
158 Not many user-visible changes but a fair amount of internal improvements.
159
160
161         - The http sender buffers data if it can not be sent
162           out immediately (because the socket is not writable). This
163           should prevent para_server from shutting down the connection
164           too early on a loaded network.
165         - para_play also prebuffers data if it is told to start at a
166           future time by the --start_time option.
167         - The return of para_recv: It combines para_ortp_recv and
168           para_http_recv. Use the --receiver option to switch between
169           the two. para_recv builds without libortp, but contains
170           only the http receiver in this case.
171         - update to ortp 0.8.1. As this ortp release contains incompatible
172           changes, para_recv-0.2.7 won't link against older ortp libs.
173         - improved ortp timings.
174         - use of gcc-extensions that #define away for non-gcc and
175           gcc < 3.0.
176
177
178 -------------------------------------------
179 0.2.6 (2005-10-29) "recursive compensation"
180 -------------------------------------------
181
182 Transparent session encryption (uses openssl's Alleged RC4 cipher),
183 the internal find command and several other improvements and cleanups.
184
185         - Encrypt the session if encryption is requested by the client
186           (default for para_client 0.2.6). This is backwards
187           compatible, so older clients can still connect to para_server
188           0.2.6. Use the new client option --plain to request an
189           uncrypted session (off by default, must be set to on in
190           order to connect to para_server 0.2.x with 0 <= x <= 5).
191         - para_server uses an internal function to locate audio files
192           rather than calling find(1). The server option
193           --mysql_audio_file_dir replaces --mysql_find_cmd.
194         - documentation update
195         - man pages
196         - header file cleanup
197         - para_client code cleanup
198         - para_gui: faster display of output of display commands
199
200
201 ------------------------------------------
202 0.2.5 (2005-10-13) "aggressive_resolution"
203 ------------------------------------------
204
205 This release adds internal senders, i.e. no more external programs are
206 spawned for sending out the audio data. There are two different senders
207 available: The http sender and the ortp sender (former para_send which
208 is no longer needed).
209
210 The new sender code has a plugin-like design so it can be easily
211 extended should there be be any future need for supporting another
212 network streaming protocol. All senders are completely independent of
213 each other. In particular, the http and the ortp sender can operate
214 in parallel.
215
216         - new server command: sender to control senders at runtime.
217           Read the output of "para_server -h" and "para_client help
218           sender" for more information.
219         - para_recv renamed to para_ortp_recv
220         - new executable: para_http_recv, a simple command line
221           http receiver.
222         - major afs/mp3/ogg code simplifications due to internal
223           senders.
224         - ogg timing improvements
225         - fix several minor memory leaks (found by valgrind)
226         - empty stream definitions work again
227         - com_ne(): ignore errors on remove
228         - audiod: fix segfault on server restart
229
230
231 ---------------------------------------
232 0.2.4 (2005-09-21) "toxic anticipation"
233 ---------------------------------------
234
235 Several small improvements, fixes and the new grab command.
236
237         - audiod:
238                 - new command: "grab" to grab the output of the stream reader
239                   or any filters. Read the output of "para_audioc help grab"
240                   for more information.
241                 - fix memory leak
242                 - code cleanup
243         - audioc: new command line option: --bufsize to specify a
244           buffer size different from the default size 8192.
245         - improved error diagnostics for para_play.
246         - new configure option: --enable-ssldir so search for openssl in
247           non-standard places
248         - sdl_gui: Make it look nice again for 1024x768
249         - server: report total size of memory allocated with sbrk by malloc,
250           new command line option: --announce_time
251
252
253 -----------------------------------------
254 0.2.3 (2005-09-01) "hydrophilic movement"
255 -----------------------------------------
256
257 Two new executables and major feature enhancements.
258
259         - audiod filters: It is now possible to specify arbitrary many
260           (including none) filters for each supported audio
261           format. This can be used e.g. for normalizing volume,
262           transforming or grabbing the audio stream, or for using
263           visualizers.  Read the output of "para_audiod -h" for the
264           syntax of the new --filter_cmd option.
265         - new executable: para_play, a tiny alsa player. It
266           can play wave files or raw pcm (16 bit little endian)
267           from stdin.
268         - new executable: para_compress, a dynamic range compressor
269           intended to keep audio output at a consistent volume. Derived
270           from AudioCompress, http://trikuare.cx/code/AudioCompress.html.
271         - audiod: New option: --stream_delay. This can be used in
272           a local network to syncronize the audio output of all
273           clients that play the same stream.
274
275
276 ------------------------------------------
277 0.2.2 (2005-08-19) "tangential excitation"
278 ------------------------------------------
279
280 Mostly internal changes in this release, but also some new commands
281 for the mysql database tool.
282
283         - cleanup exec.c, fix para_exec bug
284         - compile time loglevel (log messages below the given level
285           won't be compiled in, which reduces the size of the
286           resulting binaries)
287         - new log macros that shorten the size of the source code.
288         - workaround a gcc-4.1 bug (?) that caused send_cred_buffer()
289           to send only zeros. With this workaround, para_audioc works
290           again.
291         - avoid gcc-4 warning: conflicting types for built-in function 'clog'
292         - new mysql commands: "rm" (remove entry), "mv" (rename entry) "ne"
293           (new entry), "snp" (set numplayed). Read the manual for more
294           information.
295
296
297 ---------------------------------------
298 0.2.1 (2005-08-15) "surreal experience"
299 ---------------------------------------
300
301 Here comes paraslash-0.2.1. It contains a couple of new features and,
302 surprise, only minor bug fixes.
303
304         - kill noisy mp3 debug message
305         - cleanup of the build system
306         - para_server and para_client directly use the crypto routines
307           of the openssl library rather than invoking the openssl command
308           line utitlity
309         - server/audiod: new option --user to switch to the given user
310           when invoked as root. Read the output of "para_server -h" for
311           more information.
312         - gui/sdl_gui: new option --stat_cmd to be used to retrieve the
313           status. Default: "para_audioc stat"
314         - sdl_gui: new option --pic_cmd to be used to download the picture.
315           Default: "para_client pic"
316         - audiod: 5 slots ought to be enough for everybody
317         - audiod: new status item: Uptime, kill hup command
318
319
320
321 ------------------------------------------
322 0.2.0 (2005-08-06) "distributed diffusion"
323 ------------------------------------------
324
325 After several month of increased development activity, paraslash-0.2.0
326 has arrived. It contains many new features and is much more
327 self-contained than the old 0.1.x series. Enjoy!
328
329
330         - para_server: fix hang on song change and crash on sighup.
331           Speed up mysql queries. The DIR_LIKE macro is gone.
332         - new executables: para_audiod, the local audio daemon that
333           starts playback (uses SCM_CREDENTIALS socket magic) and
334           para_audioc, the corresponding client.
335         - new executables: para_mp3dec/para_oggdec, two really teensy
336           decoders. para_mp3dec is based on libmad, para_oggdec requires
337           libvorbisfile.
338         - ovsend/ovrecv are capable of streaming ogg as well as mp3, so
339           they are now called para_send and para_recv respectively.
340         - documentation updates
341         - para_gui is themable. For now there is the default theme that
342           looks as before and the simple theme: blue and easy.
343         - gui: audio streaming is now handled by audiod. Time display shows
344           playback time rather than streaming time
345         - slider: update to libzmw-0.2.0
346         - para_krell: fix crash on server shutdown
347         - switch from gzip to bzip2
348
349
350 ----------------------------------------
351 0.1.7 (2005-04-18) "melting penetration"
352 ----------------------------------------
353
354 The main change in this release is clearly the oggvorbis rewrite,
355 but there are also lots of smaller changes. If you intend to use both
356 the mp3 and the ogg plugin, it is recommended to use software mixing,
357 e.g. the dmix plugin which is provided by ALSA.
358
359         - new executables: para_ovsend and para_ovrecv for sending/receiving
360           oggvorbis files via rtp. Requires the open rtp library. Get it at
361           http://www.linphone.org/ortp/
362         - rewrite of the ogg_vorbis core code
363         - configure detects libzmw and, if detected, includes
364           para_slider to the list of binaries to be built by make
365         - server stream writers read from their associated fifo rather
366           than from stdin
367         - slider: two new sliders, lastplayed and numplayed
368         - fix nasty double free bug which caused random segfaults in case of
369           mp3 files with invalid header information
370         - gui: new command line option: --stream_timeout=seconds  to
371           deactivate a slot if it is idle for that many seconds (default=`5')
372         - diffstats
373
374
375 ---------------------------------------
376 0.1.6 (2005-03-05) "asymptotic balance"
377 ---------------------------------------
378
379 Only little user-visible changes in this release. Mainly bugfixes and
380 core code cleanup. This is probably the most stable version ever if you
381 stick to mp3...
382
383         - fix several memory leaks
384         - rename default name of mysql database from "music" to "paraslash".
385           Use para_server's  --mysql_database option if you do not want to
386           rename your old database.
387         - rework ogg vorbis code
388         - make update command work on mysql servers with LOCAL_INFILE
389           disabled
390         - gui: improved stream I/O (slots)
391         - simplified audio format API
392         - para_pob_ogg is gone
393
394 ------------------------------------
395 0.1.5 (2004-12-31) "opaque eternity"
396 ------------------------------------
397
398 Let's slide gently into the new year.
399
400         - new: para_slider (not built automatically, type "make
401           para_slider" to build). A toy for those who always felt that
402           creating stream definitions is difficult. See screenshots,
403           README and FEATURES for more info.
404         - improved signal handling. Fixes server segfault on SIGHUP
405           for linux kernels newer than Aug 24 2004 and makes para_gui
406           race-free.
407         - reload database tool on SIGHUP
408         - improved help message for sl
409         - do not log "broken pipe" messages as errors. They are
410           perfectly ok.
411         - fix wrong error message on permission errors
412
413 -----------------------------------------
414 0.1.4 (2004-12-19) "tunneling transition"
415 -----------------------------------------
416
417 Bugfix release. As expected, 0.1.3 introduced a bunch of new bugs.
418 Hopefully, most of them got wiped out with this release. Some
419 enhancements went also in.
420
421         - improved error diagnostics for all commands
422         - stradd/picadd: overwrite previous contents if entry already
423           exists, rather than returning errors
424         - stradd: use current stream if invoked without args
425         - faster (and hopefully more stable) ogg-vorbis handling
426         - para_krell: reap children to avoid zombie-flooding in case
427           no server is running
428         - si: report also server pid
429         - server: don't busy-loop if dbtool reports only invalid files.
430         - gui: CTRL+C works again, fix stream_read command line option
431         - fix pic_add, hist
432         - fix mysql dbtool startup in case no database exists
433         - many small fixes and cleanups
434
435 ---------------------------------------
436 0.1.3: (2004-12-10) "vanishing inertia"
437 ---------------------------------------
438
439 Starting from this release, the database tools are integrated in the
440 server binary. This decreases server startup time, reduces code size
441 and speeds up database commands. However, the layout of the underlying
442 mysql database changed only slightly and 0.1.3 should be backwards
443 compatible in that respect.
444
445 Visible changes:
446
447         - If mysql is not detected at compile time, or fails to init
448           at runtime, fall back to the dopey database tool which should
449           always work.
450         - para_dbtool and dbtool.conf are gone. All mysql specific
451           options are read from server.conf and are prefixed by 'mysql_'.
452         - new command: cdt (change database tool)
453         - new command line option: dbtool (choose startup database tool)
454         - The name of current stream is now stored in the database,
455           so paraslash remembers its current stream when restarted.
456         - new command: csp (change stream and play)
457         - para_gui also reports current database tool and server uptime
458
459
460 -------------------------------------------
461 0.1.2: (2004-11-28) "spherical fluctuation"
462 -------------------------------------------
463
464 Point release before the big dbtool changes go in.
465
466         - dbtool: rename ca to cam (copy all meta data). It now also
467           copies numplayed and lastplayed time as well as the picture
468           id.
469         - fix endless-loop-bug caused by mp3 files with invalid header
470
471 -----------------------------------------
472 0.1.1: (2004-11-05) "floating atmosphere"
473 -----------------------------------------
474
475         - gkrellm plugin
476         - new dbtool command: mbox. Browse your sound-file collection
477           with your favorite mail reader.
478         - several small fixes
479
480 -------------------------------------
481 0.1.0: (2204-10-22) "rotating cortex"
482 -------------------------------------
483
484         - fix logging bug for loglevel > VERBOSE
485         - fix skip command
486         - correct timings for vbr mp3s
487         - modular audio format support
488         - ogg-vorbis support (experimental)
489         - new server option: autoplay
490
491 -----------------------------------------
492 0.0.99: (2004-07-25) "harmonic deviation"
493 -----------------------------------------
494
495         - rename projectname from icc to paraslash (play, archive, rate
496           and stream large audio sets happily)
497         - paraslash is no longer restricted to one particular audio
498           streaming software
499         - new dbtool commands (stradd, strq, strdel) for easy stream
500           managment w/o configuration file. That obsoletes stream_defs
501           file/config option for dbtool.
502         - picadd accepts jpeg data from stdin
503         - new server commands: ps (select previous stream), sc (song change)
504         - new default pictures for sdl_gui
505         - gui: new key_map option for binding commands and internal
506           functions to arbitrary keys, nice help screen, rip out
507           soundcard/linux specific stuff, avoid noise artefacts while jumping,
508           show silly logo on startup
509         - new executables: para_fade for fading volume, para_dbadm for
510           manipulating attributes
511         - cdb adds _all_ tables to mysql database
512         - revised and beautified documentation
513         - sample dbtool rewritten in C
514         - autoconf
515
516 ---------------------------------------------
517 0.0.98: (2003-12-26) "incremental smoothness"
518 ---------------------------------------------
519
520         - kick icecast in favour of poc. That removes some races and reduces
521           core code considerably.
522         - cbr/vbr is displayed by stat and gui/sdl_gui. New status flags
523           give finer info on afs' status.
524         - gui can start decoder (see config options). Further new gui
525           commands: refresh (^L), jmp (F1-F10)
526         - gui rereads conf on SIGUSR1 instead of SIGHUP. SIGHUP
527           terminates gui. This fixes dead instances consuming memory
528           continuously.
529         - new dbtool command: verb for sending verbatim sql queries.
530         - fix pid_list races (by removing pid_list)
531         - codename funnies
532
533 --------------------
534 0.0.97: (2003-10-26)
535 --------------------
536
537         - installation prefix now defaults to /usr/local
538         - new commands for gui: snozze, sleep and reread config
539         - config file for gui and sdl_gui
540         - fix problems with filenames containing funny characters
541           (reported by Thomas Forell)
542         - improved signal handling for gui, now it rereads conf on SIGHUP
543         - new dbtool command: cdb (create database)
544         - switch from argtable to gengetopt
545         - major code cleanup and speed improvements
546         - fix several potential buffer overflows
547         - many small fixes and cleanups
548
549 -------------------
550 0.0.96 (2003-08-30)
551 -------------------
552
553         - easy stream_defs syntax
554         - sdl_gui can display images associated to the file being played
555         - Major feature enhancements for icc_gui including dynamic text
556           placement and the top/bottom window design
557         - vrfy/clean now also checks for NULL values in attributes as
558           well as for invalid picture pointers
559         - fix long outstanding case sensitivity bug
560         - many small fixes and cleanups
561
562 -------------------
563 0.0.95 (2003-06-29)
564 -------------------
565
566         - sdl gui runs much faster
567         - new dbtool command: ca (copy attributes)
568         - count and display number of times the song has been played
569         - new feature: scoring
570         - command line options for sdl_gui
571         - simpler syntax of streams file
572         - decrease network traffic of stat
573         - fix zombie bug
574         - many small fixes and cleanups
575
576 -------------------
577 0.0.94 (2003-05-04)
578 -------------------
579
580         - new server command: ns (next stream)
581         - new icc_gui command: c (change stream)
582         - internal mp3info
583         - stat shows also id3 tag info
584         - new sdl based gui
585         - log flodding bug fixed
586         - many small fixes and cleanups
587
588 -------------------
589 0.0.93 (2003-03-28)
590 -------------------
591
592         - colors for icc_gui
593         - icc_gui sets volume directly (linux only)
594         - proper locking that fixes some races
595         - fix security bug that caused commands to be executed even
596           with unsufficient permissions
597         - new command: hup to make all servers reread their configuration file
598         - icecast meta data streaming
599         - many small fixes and cleanups