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