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