Make senders independent of afs and osl.
[paraslash.git] / NEWS
1 NEWS
2 ====
3
4 -----------------------------------------------
5 0.5.4 (to be announced) "exponential alignment"
6 -----------------------------------------------
7
8         * Minor cleanups to daemon.c.
9         * New URLs for home page and git services.
10
11 Download: ./releases/paraslash-git.tar.bz2
12
13 ---------------------------------------------
14 0.5.3 (2014-08-01) "symbolic synchronization"
15 ---------------------------------------------
16
17 Not many new features, but lots of fixes and usability improvements.
18
19         - para_gui has been converted to use the paraslash scheduler.
20         - Various alsa-related fixes, mostly for the raspberry pi.
21         - Many scheduler improvements and cleanups.
22         - The test suite has been extended to include sanity checks
23           for the generated man pages.
24         - ao_writer fixes. This writer was in a quite bad shape. Many
25           serious bugs have been fixed.
26         - new audiod command: version.
27         - Minor improvements to the bitstream API.
28         - The cpsi command now prints a meaningful error message if
29           none of the given patterns matched any audio file.
30
31 Downloads: ./releases/paraslash-0.5.3.tar.bz2 (tarball),
32 ./releases/paraslash-0.5.3.tar.bz2.asc (signature)
33
34 ----------------------------------------
35 0.5.2 (2014-04-11) "orthogonal interior"
36 ----------------------------------------
37
38 The new sync filter, the AES_CTR128 stream cipher and the overhauled
39 network code are the highlights of this release. It also includes a
40 fair number of smaller fixes and improvements not mentioned here.
41
42         - The new sync filter synchronizes playback between multiple
43           clients.
44         - Connections between para_server and para_client are now
45           encrypted by means of AES rather than RC4 if both sides
46           support it. RC4 is still available as a fallback. This
47           feature is fully transparent, i.e. no command line options
48           are necessary, and a client linked against openssl can
49           speak with a server linked against libgcrypt and vice versa.
50         - Major cleanup of the networking subsystem.
51         - Improvements to para_fade: the new set mode, multi-channel
52           initial volumes, better error logging.
53         - The man pages of para_audiod, para_filter, para_recv, and
54           para_write contain the relevant options for receivers, filters,
55           writers. This broke in 0.5.0.
56         - ogg/vorbis latency improvements.
57         - Improved user manual.
58         - Minor fixes to avoid clang warnings.
59
60 Downloads: ./releases/paraslash-0.5.2.tar.bz2 (tarball),
61 ./releases/paraslash-0.5.2.tar.bz2.asc (signature)
62
63 ------------------------------------------
64 0.5.1 (2013-12-20) "temporary implication"
65 ------------------------------------------
66
67 Lots of fixes and improvements all over the place, and a major overhaul
68 of the build system.
69
70         - Audiod improvements and fixes.
71         - Buffer tree robustness improvements.
72         - Cleanup of the mood subsystem.
73         - Fixes and cleanups for the flac decoder.
74         - Latency improvements for the ogg/opus decoder.
75         - Crypto support is now optional. On systems without
76           openssl/gcrypt, the build succeeds but para_server,
77           para_audiod, para_client won't be built.
78         - The build system now works for cross-compile setups.
79         - The dependency tree has been flattened, which speeds up
80           builds and avoids to recreate the man pages on every change.
81         - The error code helper has been rewritten from perl to C,
82           which further improves build time.
83         - Many small bugs in the build system have been identified
84           and fixed.
85
86 Downloads: ./releases/paraslash-0.5.1.tar.bz2 (tarball),
87 ./releases/paraslash-0.5.1.tar.bz2.asc (signature)
88
89 ----------------------------------------
90 0.5.0 (2013-08-23) "invertible validity"
91 ----------------------------------------
92
93 Some API-breaking changes, one serious bug fix, and a lot of bike-shedding.
94
95         - The sideband compatibility code has been removed, hence
96           sideband connections (introduced in 0.4.11) are now mandatory.
97         - Addblob commands can produce output.
98         - The stat command no longer sends garbage when para_server was
99           compiled against libgcrypt.
100         - Dependencies for gengetopt files are computed automatically.
101           This eliminates a constant source of build bugs.
102         - The setatt command now accepts file name patterns rather than only
103           path names.
104         - overview.pdf is now based on dia, a simple diagram creation program.
105           The new version is much more detailed and contains descriptions of
106           the various programs of the paraslash package.
107         - The separator of all multi-word options has been changed from
108           underscore to dash. For example --log_color becomes --log-color.
109         - Overhauled web pages and the new logo.
110
111 Downloads: ./releases/paraslash-0.5.0.tar.bz2 (tarball),
112 ./releases/paraslash-0.5.0.tar.bz2.asc (signature)
113
114 --------------------------------------
115 0.4.13 (2013-07-29) "spectral gravity"
116 --------------------------------------
117
118 One more 0.4.x release before the API-breaking changes for 0.5.0 go
119 in. The main features of this release are the ogg/opus audio format,
120 and UTF-8 support, but it includes also tons of other improvements
121 and fixes all over the place.
122
123         - New audio format: ogg/opus.
124         - UTF8 support for para_gui and the mp3 audio format handler.
125         - Scheduler improvements and fixes.
126         - The obsolete gettimeofday() function has been replaced
127           by clock_gettime() on systems which support it.
128         - Speed and usability improvements for para_gui.
129         - para_client now restores the fd flags of stdin and stdout
130           on shutdown.
131         - Improved manual pages.
132         - Consistent version strings for all executables.
133         - Reduced dependencies on generated files result in fewer
134           recompilations on changes.
135         - Performance improvements for the compress filter.
136         - Improved downloads web page.
137
138 -----------------------------------------
139 0.4.12 (2012-12-20) "volatile relativity"
140 -----------------------------------------
141 The new command line player, the resample filter, ALSA support for
142 para_fade, and the improved build system are the highlights of this
143 release which probably marks the end of the 0.4.x series.
144
145         - The afh receiver and the para_play executable.
146         - The resample filter: A sample rate converter based on
147           libsamplerate.
148         - The "versions" directory has been removed from the master
149           branch. The tarballs of the old releases are now available
150           in the new "releases" branch.
151         - Overhaul of the build system: All generated files are now
152           written to the "build" directory.
153         - The modular mixer API and the alsa mixer.
154         - Minor fixes for the osx writer.
155
156 --------------------------------------
157 0.4.11 (2012-07-20) "mutual diversity"
158 --------------------------------------
159
160 The major feature in this release is the new sideband API for
161 client-server communication. This API will be used exclusively starting
162 with 0.5.0, which breaks backward compatibility but allows to get rid
163 of quite some compatibility code. Other noteworthy changes include
164 decoder latency improvements and a long-standing bug fix for the
165 ALSA writer.
166
167         - Sideband connections: If both para_server and para_client
168           support this feature, data is sent as a multiplexed stream.
169         - The --no_default_filters option of para_filter has been
170           removed.
171         - Several fixes and latency improvements to various decoders.
172         - The ALSA writer now limits the prebuffer time to 500ms.
173         - Documentation improvements.
174         - Overhaul of the command_util.sh script.
175         - Fixes for some minor problems found by the clang analyzer.
176         - Compiles (almost) without warnings on gcc-3.
177         - Robustness improvements of the buffer tree code.
178
179 ------------------------------------------
180 0.4.10 (2012-03-30) "heterogeneous vacuum"
181 ------------------------------------------
182
183 Nothing earth-shaking in this release, but quite a few usability
184 improvements and the usual mix of cleanups and fixes.
185
186         - The --no_default_filters option of para_filter has been
187           deprecated. It still works but has no effect and will be
188           removed in the next version.
189         - para_gui now prints also the stderr output of the executing
190           command in the bottom window.
191         - Cleanup and consolidation of the various wrappers for
192           write(), writev(), send() and friends.
193         - The obscure error messages on mmap() failures have been
194           replaced by meaningful messages. This affects mainly
195           para_afh.
196         - para_audioc: Cleanups and memory leak fixes.
197         - Test 0004-server no longer fails if para_server is not
198           being built.
199         - New configure options: --with-id3tag-{headers,libs}.
200
201 -------------------------------------
202 0.4.9 (2011-12-06) "hybrid causality"
203 -------------------------------------
204
205 Support for another audio format, interactive mode for para_client
206 and para_audiod and many small improvements/fixes all over the place.
207
208         - Support for flac, the free lossless audio codec.
209         - Fix for an endless loop in the mp3 decoder for certain
210           (corrupt) mp3 files.
211         - When executed without specifying a command, para_client
212           and para_audioc start an interactive shell (requires
213           libreadline being installed). The interactive mode offers
214           full tab completion and command line history.
215         - autogen.sh now detects a distcc setup and adjusts the
216           parameter for the -j option of make accordingly.
217         - Shared memory areas are no longer restricted to 64K. We now
218           detect the maximal size of a shared memory area at runtime.
219         - cleanup of the internal uptime API.
220         - para_server prefaults the mmapped audio file to avoid
221           delays on slow media.
222         - A new test for the test-suite that exercises the
223           communication between para_server and para_audiod.
224         - The alsa writer eats up less CPU cycles when configured to
225           use the DMIX plugin.
226         - Simplified and unified receiver code.
227         - Makefile cleanups.
228         - Commands which print a list of matching audio files now
229           emit a meaningful error message if no audio file matched the
230           given pattern(s).
231
232 --------------------------------------
233 0.4.8 (2011-08-19) "nested assignment"
234 --------------------------------------
235
236 Gcrypt support, the overhauled osx writer and regex format specifiers
237 are the highlights of this release.
238
239         - support for libgcrypt as a drop-in replacement for openssl.
240           Run configure --enable-cryptolib=gcrypt to link against
241           libgcrypt. The two crypto implementations are compatible to
242           each other, i.e. a para_client executable linked against
243           gcrypt can connect to para_server linked against libssl
244           and vice versa.
245         - Rewrite of the osx writer (output plugin for Mac OS).
246         - audiod: The format specifier for receivers, filters and
247           writers is now treated as a regular expression. This allows
248           to replace 5 lines in the config file (one for each audio
249           format) by one single line. See the manual for details.
250         - The *.cmdline.[ch] files are no longer contained in the released
251           tarballs. This reduces the size of the tarballs but requires
252           gengetopt to build the tarball.
253         - Compiles cleanly also with llvm/clang.
254         - Corrupt mp3 files are handled more gracefully.
255         - The alsa writer uses poll fds instead of computing timeouts.
256         - Cleanup of the generic writer API.
257         - sched: Optimized zero timeouts.
258         - vss timeout cleanups.
259         - oggdec fixes and improvements.
260
261 --------------------------------------
262 0.4.7 (2011-06-01) "infinite rollback"
263 --------------------------------------
264
265 The new ao writer, support for ssh RSA keys and a couple of other
266 enhancements.
267
268         - Support for ESD, Pulseaudio, AIX, Solaris, IRIX and other
269           platforms through the libao audio library.
270         - Support for RSA keys generated with ssh-keygen.
271         - configure: improved options for ogg/vorbis/speex.
272         - The git version reported by --version always matches HEAD.
273         - The autogen script detects the number of processors and
274           runs a parallel make if possible.
275         - Major cleanup of the crypto API.
276         - Documentation updates.
277
278 ------------------------------------------
279 0.4.6 (2011-03-31) "deterministic entropy"
280 ------------------------------------------
281
282 Lots of ogg/vorbis improvements, the new test suite, enhancements
283 for para_gui and a fair amount of other bug fixes.
284
285         - For DCCP/OGG streams the audio file header is only sent once
286           at the beginning of the stream rather than periodically
287           every five seconds. This reduces network traffic and the
288           FEC group size.
289         - The vorbis comment header is replaced by an empty dummy header
290           before the header is sent over the network. This also results in
291           less network traffic and smaller FEC groups.
292         - The new "test" make target allows to perform some sanity checks prior
293           to installing the package.
294         - ogg timing fixes and performance improvements
295         - Scheduler improvements
296         - Proper exit codes for para_write
297         - para_gui: New option --theme to select a startup theme. Several
298           other improvements and fixes.
299         - aacdec error message cleanups
300         - simplified color error handling
301
302 --------------------------------------------
303 0.4.5 (2010-12-17) "symmetric randomization"
304 --------------------------------------------
305
306 Bug fixes, internal cleanups and variable-sized FEC slices.
307
308         - Contains a fix for an invalid-free-bug in the ogg audio format
309           handler code.
310         - Switching off the DCCP sender works again.
311         - para_audiod handles crashes of para_server more robustly.
312         - Internal scheduler and writer cleanups.
313         - Reduced latency due to variable-sized FEC slices.
314         - Improved documentation and error diagnostics.
315         - The build of para_server is now optional, allowing the build
316           to succeed in case libosl is not installed.
317
318 ------------------------------------------
319 0.4.4 (2010-08-06) "persistent regularity"
320 ------------------------------------------
321
322 Support for yet another audio format, para_write improvements and
323 bug fixes.
324
325         - Support for the speex codec.
326         - Support for sample formats other than 16 bit little endian.
327         - error2.h is now created by a perl script which speeds up configure
328           considerably.
329         - Fix a bug in the aac decoder which could lead to segfaults in
330           para_filter/para_audiod.
331         - Fixes for autoconf-2.66.
332
333 ----------------------------------------
334 0.4.3 (2010-07-05) "imaginary radiation"
335 ----------------------------------------
336
337 Many improvements for the DCCP and the UDP transport, the new user
338 manual and the usual mix of bug fixes and internal improvements.
339
340         - FEC support for the DCCP sender (Gerrit Renker). The new
341           --dccp_max_slice_size, --dccp_data_slices_per_group and
342           --dccp_slices_per_group options can be used to set the FEC
343           parameters for the DCCP transport.
344         - DNS lookups for UDP targets (Gerrit Renker).
345         - The new user manual replaces the README, README.afs, REQUIREMENTS
346           and INSTALL documents.
347         - Fix an end-of-file detection bug in the oggdec filter.
348         - The new nonblock API.
349         - Both options of the oggdec filter have been removed.
350         - New debug mode for the internal scheduler.
351
352 ------------------------------------------
353 0.4.2 (2010-04-23) "associative expansion"
354 ------------------------------------------
355
356 It's been some time since the last release, but finally here is
357 paraslash-0.4.2. The bulk of the changes comes from the new buffer
358 tree API, but there are changes all over the tree. Mainly performance
359 and usability improvements, but also quite some bug fixes.
360
361         - The new buffer tree API.
362         - DCCP: Support for CCID negotiation (Gerrit Renker).
363         - UDP robustness fixes.
364         - The --bufsize option for mp3dec is gone as it no longer makes sense
365           for the new buffer tree API.
366         - Fix audible buffer underruns for wma streams.
367         - The alsa writer no longer prints meaningless underrun durations.
368         - audiod: Defaults work also for udp streams. If no filter is
369           given for an audio format that is received via upd, fecdec is
370           automatically added as the first filter (along with the decoder).
371
372 ---------------------------------------
373 0.4.1 (2009-12-22) "concurrent horizon"
374 ---------------------------------------
375
376 Support for another audio format, minor feature enhancements and lots of bug
377 fixes. All fixes that have been accumulated in the maint branch (in particular
378 those mentionened in the 0.3.6 release notes) appear in this release as well.
379
380         - wma support.
381         - new afh option: --human to activate human-readable output.
382         - new server/audiod option: --log-timing to print timing information.
383         - build system improvements.
384         - source code documentation updates.
385
386 -------------------------------------
387 0.3.6 (2009-12-07) "cubic continuity"
388 -------------------------------------
389
390 Quite a few bugs have been found and fixed since 0.3.5, so here's
391 another 0.3.x release. No new features.
392
393         - Always check return value of malloc().
394         - ogg vorbis/FEC: Do not write garbage after the audio file header.
395         - exit if root privileges could not be dropped.
396         - FEC: Fix computation of extra slices.
397         - oss: Fix check for empty input buffer.
398         - Avoid buffer underruns due to filter chain output buffer constraints.
399         - server: Fix assignment of afs_pid.
400         - Don't panic if the afs database contains unknown audio formats.
401         - http/dccp: Do not send the audio file header twice.
402         - FEC: Timing improvements.
403
404 ----------------------------------------------
405 0.4.0 (2009-11-10) "simultaneous independence"
406 ----------------------------------------------
407
408 Two significant changes which require the new version number: The
409 improved authentication dialog and the fact that the database code
410 has been moved to a library, libosl. To use the new version, you have
411 to generate new RSA keys, see INSTALL for details. A shell script is
412 provided for conversion of the 0.3 database to the new 0.4 format.
413
414         - stronger crypto for client authentication
415         - the database code has been moved to a library
416         - improved status item handling
417         - cleanup of the build system
418         - The "-V" option now also prints the git version
419         - the new parser-friendly listing mode for the ls and stat commands
420         - mandatory rc4 encryption
421         - major audio format handler cleanups
422         - (id3,...) tags are no longer stored as a combined string in the database
423         - new mood methods: artist_matches, title_matches, comment_matches,
424           album_matches, year_maches, year.
425
426 --------------------------------------------
427 0.3.5 (2009-09-21) "symplectic separability"
428 --------------------------------------------
429
430 Full client support for *BSD Unixes, complete re-write of the ogg
431 vorbis audio format handler, various improvements all over the place
432 and the usual mix of bugfixes. This release marks the end of the 0.3
433 series if no serious problems show up.
434
435         - the new oss writer (supported on *BSD and Linux)
436         - rewrite of the ogg vorbis audio format handler. It's
437           recommended to replace the chunk tables of existing ogg
438           vorbis files in the afs database by re-adding these files
439           with "add -f".
440         - support for netmask subsets (Gerrit Renker)
441         - the new prebuffer filter
442         - improved signal handling
443         - variable fec output buffer size
444         - improved FEC timing fixes audible buffer underruns in UDP mode
445         - --log_color actually works
446         - new ls option: -d (print dates as seconds after the epoch)
447         - update to gengetopt 2.22.2
448         - support for RSA keys of size > 512 bits
449         - new option "mixer_channel" for para_fade
450
451 -----------------------------------------
452 0.3.4 (2009-05-07) "elliptic inheritance"
453 -----------------------------------------
454
455 The new udp sender, forward error correction, colored logs and various
456 other improvements. As the udp sender does not depend on any special
457 libraries, it is built unconditionally.
458
459         - The udp sender replaces the ortp sender. The new code uses forward
460           error correction to protect against packet losses. Many thanks to
461           Gerrit Renker for providing ipv6 support.
462         - The default port for udp streaming now defaults to 8000, like
463           for the http and the dccp senders/receivers.
464         - Loglevels are now specified as symbolic names, e.g.
465           "--loglevel info".
466         - improved ipv4 and ipv6 URI parser (Gerrit Renker).
467         - para_server/para_audiod: Color support for log messages.
468         - new options for mp3dec: --ignore-crc, --bufsize
469         - new audiod option: --config-file.
470         - gengetopt cleanups.
471         - Improved help/man pages: The documentation of para_audiod,
472           para_recv, para_filter and para_write now also contains
473           all options of the available receivers/filters/writers. The
474           man page of para_fade contains a description of the different
475           modes of operation.
476         - More source code documentation.
477         - vss timing fixes.
478
479 --------------------------------------------
480 0.3.3 (2008-12-01) "axiomatic perspectivity"
481 --------------------------------------------
482
483 Internal code cleanups, bug fixes, improved tag handling and the new
484 amplification filter.
485
486         - para_server uses the generic scheduling code.
487         - overhaul of the virtual streaming system.
488         - mp3: id3 version 2 support via libid3tag (optional)
489         - ogg: vorbis comment support.
490         - aac meta info support.
491         - mp3 audio format handler cleanups.
492         - new filter: "amp" to amplify the amplitude of the audio stream
493         - new status item/database entry: amplification. It is
494           used by the amp filter to pre-amplify the audio stream.
495         - fix a close-without-open bug in para_write.
496         - fix a bug in com_init() which was introduced in 0.3.2.
497         - better error diagnostics for para_client.
498
499 -----------------------------------------
500 0.3.2 (2008-04-11) "probabilistic parity"
501 -----------------------------------------
502
503 The new para_afh executable, scheduling and documentation improvements.
504
505         - new ls option: -lc (list chunk table)
506         - new executable: para_afh, the stand-alone audio file handler tool
507         - afs commands can send output more than SHMMAX (32MB on Linux). This
508           also reduces the memory usage of commands that produce large amounts
509           of output.
510         - major scheduler and audiod cleanups.
511         - more detailed and much nicer man pages.
512
513 ---------------------------------------
514 0.3.1 (2008-02-23) "liquid interaction"
515 ---------------------------------------
516
517 A mix of cleanups, bug fixes, improvements, and some new features. No
518 significant changes to the new database (osl) code, which is generally
519 a good sign.
520
521         - Share some similar/duplicate code between the http and the
522           dccp sender.
523         - Generic access control lists for paraslash senders.
524         - dccp sender: Access control lists, connection limiting and support
525           for the allow,deny,on,off,help sender commands.
526         - The default dccp port changed from 5001 to 8000 (suggested by
527           Gerrit Renker).
528         - para_server starts even if not all public keys could be loaded.
529         - Audiod performance improvements.
530         - fix a bug in the "off" command of the http sender.
531         - fix some fd and memory leaks.
532         - Update to gengetopt-2.22.
533
534 -------------------------------------
535 0.3.0 (2008-01-12) "solar saturation"
536 -------------------------------------
537
538 paraslash.0.3.0 -- 'WWDBND --what would databases never do?'.
539
540
541 Usually one might expect lots of new features AND a big increase in size
542 for a major release like this.
543
544 However, paraslash-0.3.0.tar.bz2 is the smallest paraslash tarball
545 ever. The decrease in size is mostly due to the removal of some
546 graphical tools (which were only quick hacks anyway). But also the
547 fact that the mysql code is gone cuts down the size a bit.
548
549 Being independent of mysql comes at a cost: The fact that paraslash
550 now contains its own database (the object storage layer, osl) increases
551 the (stripped) binary size of para_server by ~50K on i386.
552
553         - no more restrictions on unique basenames.
554         - independent of mysql: The new self-contained object
555           storage layer (osl) replaces the mysql database.
556         - New executable para_fsck: Check integrity of osl tables.
557         - Lyrics support.
558         - Reliable audio file move/rename detection.
559         - More portable than ever: Tested on Linux (x86_32, x86_64, sparc64),
560           MacOS (ppc32, x86_32), FreeBSD (x86_32), NetBSD (x86_32) and
561           Solaris (sparc64).
562         - the new osl-based audio file selector (afs) replaces the random,
563           the playlist and the mysql selector of paraslash-0.2.x.
564         - IPv6 support (thanks to Gerrit Renker).
565         - paraslash-0.2.x streams are now called "moods". Writing
566           0.3.x-mood definitions should be both easier and more
567           powerful than writing 0.2.x-stream definitions.
568         - para_krell, para_slider, para_para_sdl_gui, para_dbadm have
569           been removed. The world is a better place without them. However,
570           para_gui is still there.
571         - afs tracks audio file selection also in playlist mode.
572         - few easy-to-use afs commands replace the many not-so-easy-to-use
573           mysql commands (and are available also in playlist mode).
574         - Improved error subsystem.
575         - The earth-shaking new logo.
576
577 -----------------------------------------
578 0.2.17 (2007-11-20) "isotropic threshold"
579 -----------------------------------------
580
581 Mainly bugfixes and cleanups in this version which marks the end of
582 the 0.2.x series if no serious bugs show up after the release.
583
584         - mysql_selector: fix a locking bug.
585         - universal chunk queueing.
586         - dccp sender uses chunk queueing if write() returns EAGAIN (thanks
587           to Gerrit Renker).
588         - be more carful wrt. signed vs. unsigned argument passing.
589         - cleanup error.h and fix some references to invalid error
590           codes.
591         - update to gengetopt-2.21.
592         - update to ortp-0.13.1.
593         - autoconf: extend checks for headers, library functions and
594           compiler characteristics.
595         - Fix streaming of large mp3 files.
596         - Fix an off-by-one bug in playlist handling.
597
598 --------------------------------------
599 0.2.16 (2007-04-05) "neural discharge"
600 --------------------------------------
601
602 The main change in this release is the major audio format handler
603 cleanup which removes some similar/duplicate code and makes it easier
604 to implement plugins for other audio formats. Of course, the usual mix
605 of other improvements/changes/bugfixes also made it into the release.
606
607         - simplified audio format handlers (most of the handling functions
608           were moved one layer up to the virtual streaming system).
609         - para_server uses mmap to read audio files
610         - repositioning of mp3 streams is much faster, in particular for
611           jumping near the end of large mp3 files.
612         - permission flags DB_READ,DB_WRITE have been renamed to AFS_READ
613           and AFS_WRITE.
614         - fix a bug in para_filter that caused decoding of aac files
615           to start only after a few seconds.
616         - fix osx_writer hangs
617         - simplified dccp code (thanks to Gerrit Renker)
618         - the compress filter works also on big endian systems (ppc)
619
620 -----------------------------------------
621 0.2.15 (2007-02-16) "inductive resonance"
622 -----------------------------------------
623
624 Minor improvements, more documentation and a bunch of bug fixes.
625
626         - para_server: The server.users file is only read once on server
627           startup rather than for each connection
628         - mp3dec: Fix decoding of corrupt mp3 files
629         - afs (audio file sender) is now called vss (virtual streaming
630           system). Consequently, the permission flags specified in
631           ~/.paraslash/server.users have also changed: AFS_READ and AFS_WRITE
632           become VSS_READ and VSS_WRITE respectively.
633         - para_audiod/para_filter: Fix a bug that caused the last chunk
634           of audio data not being written under certain circumstances
635         - audiod: compute the difference of server time and local time
636           correctly
637         - para_server/para_audiod: Fix some memory leaks
638         - documentation improvements
639         - configure.ac: fix checks for para_krell
640         - new man pages
641
642 -------------------------------------------
643 0.2.14 (2006-10-15) "transient singularity"
644 -------------------------------------------
645
646 The only major enhancement of this version is the osx writer which completes
647 the Mac OS Port and was originally planned already for 0.2.13 but had to wait
648 until now for reasons beyond the scope of this changelog entry.
649
650         - new output plugin for Mac Os: the osx writer
651         - rename configure command line options from --enable-xxx-headers to
652           --with-xxx-headers and  --enable-xxx-libs to --with-xxx-libs
653         - configure: new command line options: --with-mad-headers,
654           --with-mad-libs, --with-oggvorbis-headers, and --with-oggvorbis-libs
655         - some robustness fixes
656         - dymamic audio format recognition for audiod
657         - para_server: new command line option: --autoplay_delay
658         - para_audiod: new command line option: --clock_diff_count
659
660 ---------------------------------------
661 0.2.13 (2006-07-14) "sonic convolution"
662 ---------------------------------------
663
664 A bunch of new features and core changes.
665
666         - the new paraslash scheduler, short and sweet.
667         - Support for m4a/mp4 files via the new aac audio format
668           handler/filter (requires libfaad).
669         - each writer has its own command line parser, just like
670           para_recv and para_filter.
671         - para_client and para_audioc use the error subsystem
672         - writers are integrated in para_audiod (currently linux-only)
673         - para_client is integrated in para_audiod
674         - random/playlist selector: improved info strings
675         - new audiod commands: tasks, kill
676         - update to libortp-0.10.1
677         - para_fade: wake time defaults to 8 hours from now
678         - update to autoconf-2.60
679
680 ------------------------------------------
681 0.2.12 (2006-05-12) "oriented abstraction"
682 ------------------------------------------
683
684 Many user-visible changes in this release and lots of new
685 features:
686
687
688         - the new optional dccp sender/receiver. It uses the datagram
689           congestion control protocol. You'll need a fairly new kernel
690           for this.
691         - paraslash works on Mac OS X (thanks to Gerd Becker)
692         - para_play renamed to para_write
693         - modular output plugin design (writers) for para_write
694         - new file_writer output plugin for para_write
695         - compress filter speed improvements
696         - update to libortp-0.9.1
697         - update to gengetopt-2.17rc
698         - para_client no longer depends on libreadline (as the
699           code for the interactive mode was removed).
700         - gcc-2-95 is no longer a supported compiler. It may still
701           work, but it gets no more testing.
702         - the tarball no longer contains the screenshot images which
703           reduces its size quite a bit.
704         - configure: new command line options: --enable-mysql-headers
705           and --enable-mysql-libs
706
707 ------------------------------------
708 0.2.11 (2006-03-11) "atomic duality"
709 ------------------------------------
710
711 Here it is, the first paraslash release developed with git. There
712 are fairly many user-visible changes in this release. As two out of
713 the three "database tools" of paraslash don't use a database at all,
714 they are now called "audio file selectors" instead.
715
716
717         - the cdt command (change database tool) becomes chs (change
718           selector)
719         - no more colon separators: The syntax of some options of
720           para_audiod and para_filter have changed. Use --help for
721           more info (and some examples).
722         - update to gengetopt-2.16 (thanks to Lorenzo Bettini)
723         - switch from cvs to git (should've done that earlier)
724         - the new ipc subsystem
725         - new audio file selector: playlist
726         - para_server: the dopey selector is now called "random",
727           and is the default selector. Use the --selector option to
728           choose another selector at startup, or the chs command to
729           change the selector at runtime.
730         - X86_64 fixes (thanks to Steffen Klassert)
731         - para_play fixes
732
733 --------------------------------------
734 0.2.10 (2006-02-17) "cyclic attractor"
735 --------------------------------------
736
737 Huge documentation update, a scrollable window for para_gui, ortp
738 improvements, and of course many small fixes not mentioned here.
739 The diffstat below is rather misleading as most insertions are due
740 to the new source documentation.
741
742         - autoconf cleanup
743         - para_server also uses the new error subsystem
744         - lots of new documentation (UTSL)
745         - gui improvements:
746                 - keysyms for cursor keys and for next/previous page keys
747                 - scrollable output window
748                 - new internal commands: scroll up/down, page up/down
749                 - fix color of command output.
750         - ortp: the --chunk_time and --header flags are no longer needed
751         for para_recv/para_audiod as this information is now encoded in
752         each rtp packet sent by para_server.
753
754 -------------------------------------------
755 0.2.9 (2006-01-24) "progressive turbulence"
756 -------------------------------------------
757
758 Internal audiod receivers/filters, the new error subsystem and
759 a lot of small improvements.
760
761         - para_recv and para_filter are integrated into the para_audiod
762           binary, i.e. audiod no longer spawns a new process for
763           each receiver/filter. As para_recv and para_filter might be
764           useful as standalone programs, they still get built (linked
765           against the same object files that are also used for audiod).
766         - further ortp timing improvements should reduce the CPU usage
767           of the ortp receiver.
768         - improved audio grabbing. The 'grab' command of para_audiod
769           has its own set of command line options. Read the output of
770           "para_audioc help grab" for more info.
771         - oggdec: configurable input prebuffer size.
772         - the new error subsystem gives better error diagnostics
773           and reduces code size.
774
775 -----------------------------------------
776 0.2.8 (2006-01-02) "dynamic accumulation"
777 -----------------------------------------
778
779 The new modular filter design and the para_play-hangs bugfix.
780
781         - new executable: para_filter. It combines para_mp3dec,
782           para_oggdec and para_compress. It also adds a further filter
783           type, wav, that just inserts a wave header at the desired point
784           of the filter chain. All 'piping' is done in-memory (i.e. no
785           read/write operations are used).
786         - para_play: fix a stupid bug that caused it to hang under
787           certain circumstances.
788
789 -------------------------------------------
790 0.2.7 (2006-12-27) "transparent invariance"
791 -------------------------------------------
792
793 Not many user-visible changes but a fair amount of internal improvements.
794
795
796         - The http sender buffers data if it can not be sent
797           out immediately (because the socket is not writable). This
798           should prevent para_server from shutting down the connection
799           too early on a loaded network.
800         - para_play also prebuffers data if it is told to start at a
801           future time by the --start_time option.
802         - The return of para_recv: It combines para_ortp_recv and
803           para_http_recv. Use the --receiver option to switch between
804           the two. para_recv builds without libortp, but contains
805           only the http receiver in this case.
806         - update to ortp 0.8.1. As this ortp release contains incompatible
807           changes, para_recv-0.2.7 won't link against older ortp libs.
808         - improved ortp timings.
809         - use of gcc-extensions that #define away for non-gcc and
810           gcc < 3.0.
811
812 -------------------------------------------
813 0.2.6 (2005-10-29) "recursive compensation"
814 -------------------------------------------
815
816 Transparent session encryption (uses openssl's Alleged RC4 cipher),
817 the internal find command and several other improvements and cleanups.
818
819         - Encrypt the session if encryption is requested by the client
820           (default for para_client 0.2.6). This is backwards
821           compatible, so older clients can still connect to para_server
822           0.2.6. Use the new client option --plain to request an
823           uncrypted session (off by default, must be set to on in
824           order to connect to para_server 0.2.x with 0 <= x <= 5).
825         - para_server uses an internal function to locate audio files
826           rather than calling find(1). The server option
827           --mysql_audio_file_dir replaces --mysql_find_cmd.
828         - documentation update
829         - man pages
830         - header file cleanup
831         - para_client code cleanup
832         - para_gui: faster display of output of display commands
833
834 ------------------------------------------
835 0.2.5 (2005-10-13) "aggressive resolution"
836 ------------------------------------------
837
838 This release adds internal senders, i.e. no more external programs are
839 spawned for sending out the audio data. There are two different senders
840 available: The http sender and the ortp sender (former para_send which
841 is no longer needed).
842
843 The new sender code has a plugin-like design so it can be easily
844 extended should there be be any future need for supporting another
845 network streaming protocol. All senders are completely independent of
846 each other. In particular, the http and the ortp sender can operate
847 in parallel.
848
849         - new server command: sender to control senders at runtime.
850           Read the output of "para_server -h" and "para_client help
851           sender" for more information.
852         - para_recv renamed to para_ortp_recv
853         - new executable: para_http_recv, a simple command line
854           http receiver.
855         - major afs/mp3/ogg code simplifications due to internal
856           senders.
857         - ogg timing improvements
858         - fix several minor memory leaks (found by valgrind)
859         - empty stream definitions work again
860         - com_ne(): ignore errors on remove
861         - audiod: fix segfault on server restart
862
863 ---------------------------------------
864 0.2.4 (2005-09-21) "toxic anticipation"
865 ---------------------------------------
866
867 Several small improvements, fixes and the new grab command.
868
869         - audiod:
870                 - new command: "grab" to grab the output of the stream reader
871                   or any filters. Read the output of "para_audioc help grab"
872                   for more information.
873                 - fix memory leak
874                 - code cleanup
875         - audioc: new command line option: --bufsize to specify a
876           buffer size different from the default size 8192.
877         - improved error diagnostics for para_play.
878         - new configure option: --enable-ssldir so search for openssl in
879           non-standard places
880         - sdl_gui: Make it look nice again for 1024x768
881         - server: report total size of memory allocated with sbrk by malloc,
882           new command line option: --announce_time
883
884 -----------------------------------------
885 0.2.3 (2005-09-01) "hydrophilic movement"
886 -----------------------------------------
887
888 Two new executables and major feature enhancements.
889
890         - audiod filters: It is now possible to specify arbitrary many
891           (including none) filters for each supported audio
892           format. This can be used e.g. for normalizing volume,
893           transforming or grabbing the audio stream, or for using
894           visualizers.  Read the output of "para_audiod -h" for the
895           syntax of the new --filter_cmd option.
896         - new executable: para_play, a tiny alsa player. It
897           can play wave files or raw pcm (16 bit little endian)
898           from stdin.
899         - new executable: para_compress, a dynamic range compressor
900           intended to keep audio output at a consistent volume. Derived
901           from AudioCompress, http://trikuare.cx/code/AudioCompress.html.
902         - audiod: New option: --stream_delay. This can be used in
903           a local network to syncronize the audio output of all
904           clients that play the same stream.
905
906 ------------------------------------------
907 0.2.2 (2005-08-19) "tangential excitation"
908 ------------------------------------------
909
910 Mostly internal changes in this release, but also some new commands
911 for the mysql database tool.
912
913         - cleanup exec.c, fix para_exec bug
914         - compile time loglevel (log messages below the given level
915           won't be compiled in, which reduces the size of the
916           resulting binaries)
917         - new log macros that shorten the size of the source code.
918         - workaround a gcc-4.1 bug (?) that caused send_cred_buffer()
919           to send only zeros. With this workaround, para_audioc works
920           again.
921         - avoid gcc-4 warning: conflicting types for built-in function 'clog'
922         - new mysql commands: "rm" (remove entry), "mv" (rename entry) "ne"
923           (new entry), "snp" (set numplayed). Read the manual for more
924           information.
925
926 ---------------------------------------
927 0.2.1 (2005-08-15) "surreal experience"
928 ---------------------------------------
929
930 Here comes paraslash-0.2.1. It contains a couple of new features and,
931 surprise, only minor bug fixes.
932
933         - kill noisy mp3 debug message
934         - cleanup of the build system
935         - para_server and para_client directly use the crypto routines
936           of the openssl library rather than invoking the openssl command
937           line utitlity
938         - server/audiod: new option --user to switch to the given user
939           when invoked as root. Read the output of "para_server -h" for
940           more information.
941         - gui/sdl_gui: new option --stat_cmd to be used to retrieve the
942           status. Default: "para_audioc stat"
943         - sdl_gui: new option --pic_cmd to be used to download the picture.
944           Default: "para_client pic"
945         - audiod: 5 slots ought to be enough for everybody
946         - audiod: new status item: Uptime, kill hup command
947
948 ------------------------------------------
949 0.2.0 (2005-08-06) "distributed diffusion"
950 ------------------------------------------
951
952 After several month of increased development activity, paraslash-0.2.0
953 has arrived. It contains many new features and is much more
954 self-contained than the old 0.1.x series. Enjoy!
955
956
957         - para_server: fix hang on song change and crash on sighup.
958           Speed up mysql queries. The DIR_LIKE macro is gone.
959         - new executables: para_audiod, the local audio daemon that
960           starts playback (uses SCM_CREDENTIALS socket magic) and
961           para_audioc, the corresponding client.
962         - new executables: para_mp3dec/para_oggdec, two really teensy
963           decoders. para_mp3dec is based on libmad, para_oggdec requires
964           libvorbisfile.
965         - ovsend/ovrecv are capable of streaming ogg as well as mp3, so
966           they are now called para_send and para_recv respectively.
967         - documentation updates
968         - para_gui is themable. For now there is the default theme that
969           looks as before and the simple theme: blue and easy.
970         - gui: audio streaming is now handled by audiod. Time display shows
971           playback time rather than streaming time
972         - slider: update to libzmw-0.2.0
973         - para_krell: fix crash on server shutdown
974         - switch from gzip to bzip2
975
976 ----------------------------------------
977 0.1.7 (2005-04-18) "melting penetration"
978 ----------------------------------------
979
980 The main change in this release is clearly the oggvorbis rewrite,
981 but there are also lots of smaller changes. If you intend to use both
982 the mp3 and the ogg plugin, it is recommended to use software mixing,
983 e.g. the dmix plugin which is provided by ALSA.
984
985         - new executables: para_ovsend and para_ovrecv for sending/receiving
986           oggvorbis files via rtp. Requires the open rtp library. Get it at
987           http://www.linphone.org/ortp/
988         - rewrite of the ogg_vorbis core code
989         - configure detects libzmw and, if detected, includes
990           para_slider to the list of binaries to be built by make
991         - server stream writers read from their associated fifo rather
992           than from stdin
993         - slider: two new sliders, lastplayed and numplayed
994         - fix nasty double free bug which caused random segfaults in case of
995           mp3 files with invalid header information
996         - gui: new command line option: --stream_timeout=seconds  to
997           deactivate a slot if it is idle for that many seconds (default=`5')
998         - diffstats
999
1000 ---------------------------------------
1001 0.1.6 (2005-03-05) "asymptotic balance"
1002 ---------------------------------------
1003
1004 Only little user-visible changes in this release. Mainly bugfixes and
1005 core code cleanup. This is probably the most stable version ever if you
1006 stick to mp3...
1007
1008         - fix several memory leaks
1009         - rename default name of mysql database from "music" to "paraslash".
1010           Use para_server's  --mysql_database option if you do not want to
1011           rename your old database.
1012         - rework ogg vorbis code
1013         - make update command work on mysql servers with LOCAL_INFILE
1014           disabled
1015         - gui: improved stream I/O (slots)
1016         - simplified audio format API
1017         - para_pob_ogg is gone
1018
1019 ------------------------------------
1020 0.1.5 (2004-12-31) "opaque eternity"
1021 ------------------------------------
1022
1023 Let's slide gently into the new year.
1024
1025         - new: para_slider (not built automatically, type "make
1026           para_slider" to build). A toy for those who always felt that
1027           creating stream definitions is difficult. See screenshots,
1028           README and FEATURES for more info.
1029         - improved signal handling. Fixes server segfault on SIGHUP
1030           for linux kernels newer than Aug 24 2004 and makes para_gui
1031           race-free.
1032         - reload database tool on SIGHUP
1033         - improved help message for sl
1034         - do not log "broken pipe" messages as errors. They are
1035           perfectly ok.
1036         - fix wrong error message on permission errors
1037
1038 -----------------------------------------
1039 0.1.4 (2004-12-19) "tunneling transition"
1040 -----------------------------------------
1041
1042 Bugfix release. As expected, 0.1.3 introduced a bunch of new bugs.
1043 Hopefully, most of them got wiped out with this release. Some
1044 enhancements went also in.
1045
1046         - improved error diagnostics for all commands
1047         - stradd/picadd: overwrite previous contents if entry already
1048           exists, rather than returning errors
1049         - stradd: use current stream if invoked without args
1050         - faster (and hopefully more stable) ogg-vorbis handling
1051         - para_krell: reap children to avoid zombie-flooding in case
1052           no server is running
1053         - si: report also server pid
1054         - server: don't busy-loop if dbtool reports only invalid files.
1055         - gui: CTRL+C works again, fix stream_read command line option
1056         - fix pic_add, hist
1057         - fix mysql dbtool startup in case no database exists
1058         - many small fixes and cleanups
1059
1060 ---------------------------------------
1061 0.1.3: (2004-12-10) "vanishing inertia"
1062 ---------------------------------------
1063
1064 Starting from this release, the database tools are integrated in the
1065 server binary. This decreases server startup time, reduces code size
1066 and speeds up database commands. However, the layout of the underlying
1067 mysql database changed only slightly and 0.1.3 should be backwards
1068 compatible in that respect.
1069
1070 Visible changes:
1071
1072         - If mysql is not detected at compile time, or fails to init
1073           at runtime, fall back to the dopey database tool which should
1074           always work.
1075         - para_dbtool and dbtool.conf are gone. All mysql specific
1076           options are read from server.conf and are prefixed by 'mysql_'.
1077         - new command: cdt (change database tool)
1078         - new command line option: dbtool (choose startup database tool)
1079         - The name of current stream is now stored in the database,
1080           so paraslash remembers its current stream when restarted.
1081         - new command: csp (change stream and play)
1082         - para_gui also reports current database tool and server uptime
1083
1084 -------------------------------------------
1085 0.1.2: (2004-11-28) "spherical fluctuation"
1086 -------------------------------------------
1087
1088 Point release before the big dbtool changes go in.
1089
1090         - dbtool: rename ca to cam (copy all meta data). It now also
1091           copies numplayed and lastplayed time as well as the picture
1092           id.
1093         - fix endless-loop-bug caused by mp3 files with invalid header
1094
1095 -----------------------------------------
1096 0.1.1: (2004-11-05) "floating atmosphere"
1097 -----------------------------------------
1098
1099         - gkrellm plugin
1100         - new dbtool command: mbox. Browse your sound-file collection
1101           with your favorite mail reader.
1102         - several small fixes
1103
1104 -------------------------------------
1105 0.1.0: (2004-10-22) "rotating cortex"
1106 -------------------------------------
1107
1108         - fix logging bug for loglevel > VERBOSE
1109         - fix skip command
1110         - correct timings for vbr mp3s
1111         - modular audio format support
1112         - ogg-vorbis support (experimental)
1113         - new server option: autoplay
1114
1115 -----------------------------------------
1116 0.0.99: (2004-07-25) "harmonic deviation"
1117 -----------------------------------------
1118
1119         - rename projectname from icc to paraslash (play, archive, rate
1120           and stream large audio sets happily)
1121         - paraslash is no longer restricted to one particular audio
1122           streaming software
1123         - new dbtool commands (stradd, strq, strdel) for easy stream
1124           managment w/o configuration file. That obsoletes stream_defs
1125           file/config option for dbtool.
1126         - picadd accepts jpeg data from stdin
1127         - new server commands: ps (select previous stream), sc (song change)
1128         - new default pictures for sdl_gui
1129         - gui: new key_map option for binding commands and internal
1130           functions to arbitrary keys, nice help screen, rip out
1131           soundcard/linux specific stuff, avoid noise artefacts while jumping,
1132           show silly logo on startup
1133         - new executables: para_fade for fading volume, para_dbadm for
1134           manipulating attributes
1135         - cdb adds _all_ tables to mysql database
1136         - revised and beautified documentation
1137         - sample dbtool rewritten in C
1138         - autoconf
1139
1140 ---------------------------------------------
1141 0.0.98: (2003-12-26) "incremental smoothness"
1142 ---------------------------------------------
1143
1144         - kick icecast in favour of poc. That removes some races and reduces
1145           core code considerably.
1146         - cbr/vbr is displayed by stat and gui/sdl_gui. New status flags
1147           give finer info on afs' status.
1148         - gui can start decoder (see config options). Further new gui
1149           commands: refresh (^L), jmp (F1-F10)
1150         - gui rereads conf on SIGUSR1 instead of SIGHUP. SIGHUP
1151           terminates gui. This fixes dead instances consuming memory
1152           continuously.
1153         - new dbtool command: verb for sending verbatim sql queries.
1154         - fix pid_list races (by removing pid_list)
1155         - codename funnies
1156
1157 --------------------
1158 0.0.97: (2003-10-26)
1159 --------------------
1160
1161         - installation prefix now defaults to /usr/local
1162         - new commands for gui: snozze, sleep and reread config
1163         - config file for gui and sdl_gui
1164         - fix problems with filenames containing funny characters
1165           (reported by Thomas Forell)
1166         - improved signal handling for gui, now it rereads conf on SIGHUP
1167         - new dbtool command: cdb (create database)
1168         - switch from argtable to gengetopt
1169         - major code cleanup and speed improvements
1170         - fix several potential buffer overflows
1171         - many small fixes and cleanups
1172
1173 -------------------
1174 0.0.96 (2003-08-30)
1175 -------------------
1176
1177         - easy stream_defs syntax
1178         - sdl_gui can display images associated to the file being played
1179         - Major feature enhancements for icc_gui including dynamic text
1180           placement and the top/bottom window design
1181         - vrfy/clean now also checks for NULL values in attributes as
1182           well as for invalid picture pointers
1183         - fix long outstanding case sensitivity bug
1184         - many small fixes and cleanups
1185
1186 -------------------
1187 0.0.95 (2003-06-29)
1188 -------------------
1189
1190         - sdl gui runs much faster
1191         - new dbtool command: ca (copy attributes)
1192         - count and display number of times the song has been played
1193         - new feature: scoring
1194         - command line options for sdl_gui
1195         - simpler syntax of streams file
1196         - decrease network traffic of stat
1197         - fix zombie bug
1198         - many small fixes and cleanups
1199
1200 -------------------
1201 0.0.94 (2003-05-04)
1202 -------------------
1203
1204         - new server command: ns (next stream)
1205         - new icc_gui command: c (change stream)
1206         - internal mp3info
1207         - stat shows also id3 tag info
1208         - new sdl based gui
1209         - log flodding bug fixed
1210         - many small fixes and cleanups
1211
1212 -------------------
1213 0.0.93 (2003-03-28)
1214 -------------------
1215
1216         - colors for icc_gui
1217         - icc_gui sets volume directly (linux only)
1218         - proper locking that fixes some races
1219         - fix security bug that caused commands to be executed even
1220           with unsufficient permissions
1221         - new command: hup to make all servers reread their configuration file
1222         - icecast meta data streaming
1223         - many small fixes and cleanups