readme

BonkEnc is a CD ripper and audio encoder for various formats. It can produce MP3, Ogg Vorbis, BONK,

BonkEnc version 1.0 beta 2

BonkEnc is an encoder for various audio formats. It can
produce MP3, Ogg Vorbis, BONK, AAC and VQF files.

BonkEnc uses Albert L. Fabers CDRip DLL for audio ripping.

History
-------

	Version 1.0 beta 2 (February 2004)

		- added support for filename generation patterns
		- added Greek, Japanese, Chinese (simplified) and Polish language support
		- added support for right-to-left scripts like Arabic or Hebrew
		- new (partial) Arabic translation (for demonstration purpose)
		- upgraded to smooth v0.8.64.0
		- improved setup compatibility with Windows 9x/ME
		- improved overall stability especially on Windows 9x/ME
		- moved I18n capabilities to smooth
		- config dialog asks to create missing output directory
		- output directory can be changed from the main screen
		- read and write Vorbis comments in UTF-8 format
		- now using an XML based config system
		- upgraded LAME to version 3.95.1
		- upgraded Ogg Vorbis to version 1.0.1
		- upgraded FAAC to version 1.23.5 and added to the main distribution
		- added support for 24 and 32 bit AAC output
		- the BonkEnc distribution now includes the FAAD2 in_mp4.dll for AAC/MP4 input
		- added support for CDDB protocol version 6 (UTF-8 support)
		- added buttons to select all/none/toggle joblist entries
		- added 'Tip of the day' dialog
		- added automatic update notification
		- many smaller improvements
		- lots of bugfixes

	Version 1.0 beta 1 (July 2003)

		- the command line tool is now in a separate executable
		- CDDB querying has been improved (dialog with abort button)
		- the genre field is now editable
		- invalid characters in filenames are now replaced
		- improved freedb support
		- upgraded to smooth v0.8.62.0
		- added support for Windows 95
		- upgraded to CDRip v118 (own build)
		- added support for MSLU (Unicode support for Windows 9x/ME)
		- many smaller improvements
		- added support for Winamp Input Plugins
		- added support for audio playback through Winamp Output Plugins
		- upgraded FAAC to version 1.17
		- improved ASPI detection
		- some expert settings can now be set for the LAME encoder
		- title information can now be extracted from the filename
		- fixed BonkEnc lagging when running for a longer time
		- fixed many input format restrictions
		- fixed many bugs and memory leaks

	Version 0.9 (March 2003)

		- added Drag & Drop functionality
		- added support for LAME presets
		- added Hungarian, French, Russian, Serbian and Finnish language support
		- removed support for the META tag in BONK files
		- added support for ID3V2 tags in BONK files
		- added support for reading ID3V2 and Vorbis comment tags
		- added full CDDB/freedb support
		- added a CDDB cache
		- simplified the language file format
		- upgraded to smooth v0.8.61.0
		- upgraded to CDRip v117 to fix some ASPI issues
		- upgraded LAME to version 3.93.1
		- upgraded FAAC to version 1.14
		- greatly improved joblist and other GUI improvements
		- some minor enhancements and bugfixes

	Version 0.8 (November 2002)

		- added CDDB/freedb support (read only)
		- added support for decoding MP3, Ogg Vorbis and BONK files
		- implemented a command line interface
		- added Spanish, Italian and Dutch language support
		- added ID3V2 tag support
		- added the smooth Translator utility for editing language files
		- added mouse wheel support
		- upgraded to smooth v0.8.60.0
		- some small improvements
		- some bugfixes

	Version 0.7 (September 2002)

		- added support for CD text
		- added support for encoding TwinVQ (VQF) files
		- added internationalization support through XML language files
		- made binary distribution with Progressive Setup
		- upgraded to smooth v0.8.59.0

	Version 0.6 (August 2002)

		- upgraded to smooth v0.8.58.1
		- upgraded to Ogg Vorbis v1.0
		- upgraded to BONK v0.6
		- upgraded to CDRip v116
		- added support for ripping to PCM WAVE files
		- added support for encoding lossless BONK files
		- the BONK format has been extended by the META-tag
		- all encoders and decoders are now implemented as IOLib filters
		- all encoder DLLs are now optional
		- some minor bugfixes

	Version 0.5-pre2 (June 2002)

		- added support for ripping audio CDs
		- added support for Ogg Vorbis files
		- added support for FAAC (AAC encoder)
		- added support for LAME
		- added support for mono and different sampling rates
		- the BONK format has been extended to support instant skipping
		- added preliminary support for Apple AIFF, Creative Voice and Sun Audio files
		- allowed more options for BladeEnc
		- upgraded to smooth v0.8.58.0

	Version 0.4 (June 2001)

		- initial release

Requirements
------------

	- Windows NT/2000/XP, Windows 95/98/SE/ME
	- A 200MHz processor or better for playing BONK files
	- Winamp is required to play BONK files in Windows
	- You'll need properly installed ASPI drivers for CD ripping.

	Additional requirements for compiling the sources:

		- MinGW v1.x (http://www.mingw.org/) or MSVC v6.0
		- smooth v0.8.64.0 CVS (http://www.smooth-project.org/)
		- IOLib v5.x (http://www.iolib.org/ - included with smooth)

	Additional optional software:

		- BladeEnc is used if installed (http://bladeenc.mp3.no/)
		- TwinVQ is used if installed (http://www.twinvq.org/)
		- Winamp 2 input and output plug-ins are used if they are found in the plugins directory
		- MSLU is used if installed on Windows 9x/ME systems (http://www.microsoft.com/)

Problems
--------

	- There are the following restrictions on the input file format:

		- BladeEnc:
				- files must be at 32, 44.1 or 48kHz
		- LAME:
				- files must be at standard rates (8, 11.025, 12, 16, 22.05, 24, 32, 44.1, 48kHz)
		- TwinVQ:
				- files must be at 22.05kHz (24 and 32kBit) or 44.1kHz (48kBit)

	- Resampling is only supported with LAME. Input files must be at the desired output
	  sampling rate unless you are encoding with LAME.

	- Unicode characters are replaced with '#' in file names, as IOLib does not support Unicode filenames, yet.

	- The command line interface doesn't support options for modifying encoder settings, yet.

Future plans
------------

	- Sheduled for v1.0
		* shell integration
		* local CDDB support
		* write online documentation for BonkEnc
		* add online update functionality
		* clean CDDB code

	- Some later release
		* input filters for AAC, VQF
		* support more audio formats (FLAC, MAC, WMA, ...)
		* develop an IOLib-Filters based plugin system
		* add musicbrainz.org support
		* allow command line options to configure encoder settings

	- All time tasks
		* support more languages
		* cleanup the code

-----------------------------------------------------------------------------------

The official BonkEnc homepage: http://www.bonkenc.org/
Paul F. Harrison's BONK page: http://www.logarithmic.net/pfh/bonk

[e-mail],
Robert Kausch

ICQ#23891569