From 97d87e1fa0808cf747bf0a4fe3b39d1cbdb5efc8 Mon Sep 17 00:00:00 2001 From: Martin Michlmayr Date: Sun, 5 Feb 2006 20:24:07 +0100 Subject: Import jack_3.1.1+cvs20050801.orig.tar.gz [dgit import orig jack_3.1.1+cvs20050801.orig.tar.gz] --- doc/CHANGELOG | 116 +++++ doc/ChangeLog | 1193 ++++++++++++++++++++++++++++++++++++++++++++ doc/INSTALL | 87 ++++ doc/TODO | 12 + doc/anim.written.in.vi.gif | Bin 0 -> 5815 bytes doc/download.gif | Bin 0 -> 5729 bytes doc/download.html | 131 +++++ doc/examples.html | 96 ++++ doc/faq.html | 75 +++ doc/gpl.txt | 340 +++++++++++++ doc/index.html | 177 +++++++ doc/install.gif | Bin 0 -> 4340 bytes doc/install.html | 53 ++ doc/jack-curses-screen.gif | Bin 0 -> 13521 bytes doc/jack-logo.jpg | Bin 0 -> 9185 bytes doc/jack-screen.gif | Bin 0 -> 9077 bytes doc/links.gif | Bin 0 -> 3892 bytes doc/links.html | 81 +++ doc/main.gif | Bin 0 -> 3763 bytes doc/mine.css | 96 ++++ doc/requirements.gif | Bin 0 -> 5337 bytes doc/requirements.html | 72 +++ doc/screen.gif | Bin 0 -> 5094 bytes doc/screen.html | 62 +++ doc/todo.html | 43 ++ doc/usage.gif | Bin 0 -> 4233 bytes doc/usage.html | 329 ++++++++++++ 27 files changed, 2963 insertions(+) create mode 100644 doc/CHANGELOG create mode 100644 doc/ChangeLog create mode 100644 doc/INSTALL create mode 100644 doc/TODO create mode 100644 doc/anim.written.in.vi.gif create mode 100644 doc/download.gif create mode 100644 doc/download.html create mode 100644 doc/examples.html create mode 100644 doc/faq.html create mode 100644 doc/gpl.txt create mode 100644 doc/index.html create mode 100644 doc/install.gif create mode 100644 doc/install.html create mode 100644 doc/jack-curses-screen.gif create mode 100644 doc/jack-logo.jpg create mode 100644 doc/jack-screen.gif create mode 100644 doc/links.gif create mode 100644 doc/links.html create mode 100644 doc/main.gif create mode 100644 doc/mine.css create mode 100644 doc/requirements.gif create mode 100644 doc/requirements.html create mode 100644 doc/screen.gif create mode 100644 doc/screen.html create mode 100644 doc/todo.html create mode 100644 doc/usage.gif create mode 100644 doc/usage.html (limited to 'doc') diff --git a/doc/CHANGELOG b/doc/CHANGELOG new file mode 100644 index 0000000..632be8b --- /dev/null +++ b/doc/CHANGELOG @@ -0,0 +1,116 @@ + +############################################################################### +########################## pre-CVS changes follow: ############################ +############################################################################### + +##### This is jack 2.2.2 ... + ### changes from version 2.1.1 (internal) include: + # added curses frontend + # added support for variable bitrate MP3s (currently only for lame) + # bugfix: cddb query disc length was 2 seconds too short (thanks to + Martin Suess for the hint). I still don't understand where and + why I need the MSF OFFSET of 150 blocks, can anyone explain? + # bugfix: freedb files with more than one line of ids confused jack, + thanks to "casret" for the patch + ### changes from version 2.1.0 include: + # moved the toc_proc variable a bit lower in the .jackrc 'coz it's confusing + # change: in the jack.progress file, track numbers are now %02i + # bugfix: sometimes the :-) was not updated in case of an error, now it is + # bugfix: pause works now... + # bugfix: update interval no longer effects speed on non-Linux (i hope!) + ### changes from version 2.0.1 include: + # bugfix: the NameError: cd_device bug is gone (I never saw this as I + didn't change _my_ .jackrc... sorry) + # bugfix: same for "... maybe ... is not installed" + # added on-the-fly operation for cdparanoia, lame, mp3enc + # added 40 second pause before displaying global ETA so it can stabilize + # added option to execute user-defined commands - when done without errors + - when done with errors + - when ripping is finished + # added version check for .jackrc + # change: "Various" in freedb data is now treated like "Various Artists" + # added check for bogous DAE run without reported error (by checking filesize) + # bugfix: ZeroDivisionError when a lonely encoder was killed + # added better source code formatting :) + ### changes from version 2.0.0 include: + # bugfix: jack tried to chdir into newly created dirs twice + # bugfix: subdirs were created in the wrong sequence + ### changes from version 1.3.5 include: + # MANY changes and improvements, let's see if i can remember all: + # removed all thread and Queue stuff, much less trouble now + # removed resource control (ulimit), jack now quits gracefully + # added run-time commands, run jack -h to see details + # added directory creation and naming + # added directory auto-search magic, if jack doesn't find a toc-file, + it scans sub-directories (where and how deep is configurable) for + a matching toc-file and continues work + # added base_dir option, controls where new dirs are created. If you set + your prefs the right way, you only have to change CDs and type + "jack" from time to time. + # added no-various option to prevent "Various Artists" auto-detection + # added option to re-create progress file + # added update_interval, status is now updated regularily and no longer + in reaction to sub-process output + # added total ETA (only for encoders) + # changed jack so that it should (finally!) run on FreeBSD and most + other unices + # performance enhancements, jack only wastes < 0.1 % of _my_ CPU time + ### changes from version 1.3.4 include: + # added support for tosha(gettoc&DAE) PLEASE help me get jack to work on + FreeBSD. Something's wrong with threading I fear. + # bugfix: jack reported "WAV lost" when the wav was removed on purpose + # bugfix: jack encoded WAVs when resuming even if only_dae was set + ### changes from version 1.3.3 include: + # bugfix: jack reported "wrong disc" in error + # change: track 1 pregap is now stored in "SILENCE" in tocfile. Re-generate + your jack.toc files! + ### changes from version 1.3.2b include: + # better version of cdrdao_gettoc + # added resource module auto-detection + # added cheesy pause function: touch or rm "jack.pause". + # added disc recheck before each DAE is started + # added --todo: print what is to be done and exit + # bugfix: MP3s are now also checked for not being too large + # bugfix: MP3s bitrate is now remembered, too + # change: --force now disables check for correct CD inserted + # change: --force now disables check for previous encoder run (like when + manually encoding) + # added support for MP3s not starting at file's start (like RIFFs) (guess_toc) + # bugfix: freedb file: DISCID can now be comma-sep. list + ### changes from version 1.3.2a include: + # rewrote freedb_names + # removed sanity_check_freedb_file, freedb_names does the job now + # tried to make error messages uniform + ### changes from version 1.3.2 include: + # added rename_fmt option to .jackrc (use this to change renaming layout) + # added rename_underscore option to .jackrc (use this to change " " to "_") + ### changes from version 1.3.1 include: + # added dae_prog option to .jackrc + # added cd_device option to .jackrc (point it to your CD-ROM device) + ### changes from version 1.3 include: + # announced on freshmeat (famous last words...) + # now using Ben Gertzfield's ID3 module for id3tag info setting + # added guess mode + # added sysload reaction + # added (buggy) free space rechecking + # added dont-work switch + ### changes from version 1.2 include: + # public release under GPL + # added encoder support: lame, l3enc, mp3enc + # rewrote todo detection + # added only_dae flag + # added dialog which asks before deleting anything + # bugfixes + ### changes from version 1.1 include: + # added stupid function to "rip" from image + # added cool function to "rip" from cdrdao toc-file + # added toc-file writing + # added freedb lookup + renaming + id3tag setting + # handles multiple/nonexact freedb matches + # added freedb submissions + # added xtermset support + ### changes from version 1.0 include: + # stupid semaphore initialization bug fixed + # free space check is no longer braindead + # we don't try to remove() nonexistent files anymore + diff --git a/doc/ChangeLog b/doc/ChangeLog new file mode 100644 index 0000000..e4223cd --- /dev/null +++ b/doc/ChangeLog @@ -0,0 +1,1193 @@ +2004-12-12 22:52 zarne + + * jack_version.py, setup.py: + + - bump version for 3.1.1 release + +2004-12-12 05:54 zarne + + * jack.man, jack_config.py, jack_functions.py, jack_helpers.py, + jack_main_loop.py, jack_t_curses.py: + + - the usage/copyright box stays on top now by default, disable it + by pressind '?' or with --usage-win=no + + - pprint_speed() (internal) + + - documentation updates + +2004-12-12 03:27 zarne + + * jack_prepare.py: + + - fixed a warning regarding non-audio tracks + +2004-12-12 03:03 zarne + + * jack_plugins.py: + + - new plugin architecture (I forgot to include this earlier today) + +2004-12-12 03:02 zarne + + * jack, jack.man, jack_checkopts.py, jack_config.py, jack_misc.py, + jack_t_curses.py, jack_utils.py: + + - fixed --remove-files + + - fixed --exec + + - help the user if dir_template is longer than scan_dirs + + - documentation updates + + - allow the dir_template to consist of more than two path elements + + - curses: fix dae status display + +2004-12-12 01:04 zarne + + * jack.man, jack_config.py, jack_main_loop.py, jack_misc.py, + jack_t_curses.py: + + - curses: fix display of the special line + + - --max-load now takes a float argument + + - simplify loadavg() + +2004-12-11 23:52 zarne + + * jack_checkopts.py, jack_config.py, jack_main_loop.py, + jack_prepare.py: + + - 31_wrong_char_in_status.patch + + - 18_less_verbose_gen_device_warning.patch + + - 28_avoid_empty_USER_LOGNAME.patch + +2004-12-11 23:14 zarne + + * setup.py: + + - added the new modules to the setup script + +2004-12-11 22:12 zarne + + * example.etc.jackrc: + + - added an example for the global config file /etc/jackrc + +2004-12-11 21:57 zarne + + * jack_plugin_cddb.py, jack_plugin_lame.py: + + - added example plugin files + +2004-12-11 21:55 zarne + + * jack_checkopts.py, jack_config.py, jack_freedb.py, + jack_generic.py, jack_globals.py, jack_helpers.py, jack_prepare.py, + jack_rc.py: + + - new plugin architecture for rippers, encoders and freedb-servers + (so far) + +2004-12-11 19:15 zarne + + * jack_config.py, jack_freedb.py, jack_generic.py, + jack_t_curses.py, doc/ChangeLog: + + - fixed a curses bug preventing some from ripping CDs with more + tracks than lines in the terminal + + - debug stuff + + - cosmetic stuff + +2004-11-23 01:06 zarne + + * jack_helpers.py: + - remove debug stuff + +2004-11-23 00:45 zarne + + * jack.man, jack_argv.py, jack_checkopts.py, jack_config.py, + jack_freedb.py, jack_workers.py: + - manpage updates + + - removed --no-various because + + - --various=no now actually works + + - block more options from being written to jackrc + + - --otf works again (but isn't displayed right all the time) + +2004-11-22 19:59 zarne + + * jack_helpers.py, jack_main_loop.py, jack_rc.py: + - more fixes to cdparanoia status decoding + + - jack_rcversion is written to newly created rc-files + +2004-11-22 00:34 zarne + + * jack.man, jack_helpers.py, jack_rc.py: + - fix creation of ~/.jack3rc + + - take all debian updates for the manpage (thank you Michael!) + +2004-11-22 00:07 zarne + + * jack_helpers.py, jack_version.py, setup.py, doc/INSTALL: + - begin jack 3.1 release cycle + + - modest update to INSTALL doc + +2004-11-21 23:42 zarne + + * jack_argv.py, jack_checkopts.py, jack_config.py, jack_helpers.py, + jack_main_loop.py, jack_prepare.py, jack_rc.py, jack_version.py, + jack_workers.py: + - update copyright year(s) + + - remove "charset has no effect without a char_filter" warning, + charset is used by the ogg tagger + + - disallow saving of the --dont-work option + + - add version-string (and checking) to the rc-files. + +2004-11-21 22:44 zarne + + * jack_argv.py, jack_checkopts.py, jack_config.py, jack_helpers.py, + jack_main_loop.py, jack_prepare.py, jack_rc.py, jack_workers.py: + - allow the argument to --quality to be a float. oggenc is fine + with that, lame seems to truncate the float but works. + + - fixed some typos + + - fixed --check-toc + +2004-11-21 21:33 zarne + + * jack_argv.py, jack_config.py, jack_helpers.py, jack_main_loop.py, + jack_rc.py: + - allow for lists (like --unusable-chars) to be --save'd to + .jack3rc + + - lame encoder now uses --vbr-new + + - lame encoder now uses --preset instead of --alt-preset + + - fixed the "error decoding status" issue, which I think is + actually a bug in cdparanoia which outputs lots of invisible junk + after ripping. The fix may break other helpers, I only tested lame, + oggenc, cdparanoia and cdda2wav + + - added lame-user which uses -V and uses the quality specified with + --quality + + - changed LAME default quality to 6, which will result in 4 being + used when using --encoder-name lame-user (ignored otherwise) + + - cdda2wav now uses the --device, not the --raw-device. Seems to + work fine. + + - cdda2wav now uses -v toc instead of -v 35 (the latter being + obsolete soon) + +2004-11-18 03:08 zarne + + * jack, jack_config.py, jack_helpers.py: + - added the option "--query-if-needed" which only queries freedb if + there is no file called "jack.freed.bak" (which is, among other + things, the result of a successful freedb-query). + +2004-11-17 22:55 zarne + + * jack_argv.py, jack_rc.py: + - changed the UI a bit. Options can now be set with --option=value. + Use "yes" or "no" for booleans. --option alone still toggles the + current value. Toggeling sounded like a nice idea in the early days + of jack but now, with 2 rc-files and the command-line things have + gotten out of hand. + + - Booleans are now saved (--save) as option:value in the rc-files. + Please use that syntax in /etc/jackrc, too. This will hopefully + bring order to the chaos. + +2004-11-17 21:26 zarne + + * jack_ripstuff.py, jack_t_curses.py: + - fixed the infamous curses addstr bug. Why did it ever work? + +2004-11-10 00:42 zarne + + * jack, jack_CDTime.py, jack_TOC.py, jack_TOCentry.py, + jack_freedb.py, jack_functions.py, jack_mp3.py, jack_version.py: + - re-added those files (I'm running out of brown paper bags) + + - cosmetic stuff + + - one little bug fixed + +2004-08-25 04:36 zarne + + * jack_freedb.py: + - fixed http_proxy for --submit + +2004-08-25 00:53 zarne + + * jack_CDTime.py, jack_TOC.py, jack_TOCentry.py, jack_checkopts.py, + jack_display.py, jack_freedb.py, jack_globals.py, jack_mp3.py, + jack_prepare.py, jack_t_dumb.py, jack_term.py, jack_workers.py: + - removed some unused files + + - --submit works again + + - --mail-submit works again (but use --submit if possible) + + - --silent mode works again + +2004-03-25 03:55 zarne + + * jack_freedb.py: - "VA" is now recognized as various + + - fixed another forgotten cf[] (thanks to Stephan Helma for the + patch) + +2003-12-02 02:49 zarne + + * jack, jack_checkopts.py, jack_config.py, jack_generic.py, + jack_globals.py, jack_helpers.py: - fixed cdparanoia status decode + bug (I hope) + + - new option --debug, obsoletes DEBUG in jack_generic + + - make --my-mail actually work, better sanity check of the address + +2003-12-02 01:51 zarne + + * jack, jack_prepare.py, jack_t_curses.py, jack_version.py: - fix a + free diskspace-related bug + + - we're in 2003 now :] + + - expand ~ in base_dir so it can be relative to the user's homedir + +2003-11-26 19:16 zarne + + * jack_prepare.py, jack_ripstuff.py: - raw_space was moved but I + forgot that in jack_prepare. fixed. + +2003-11-26 19:02 zarne + + * setup-cursesmodule.py, setup-jack.py, setup.py, doc/ChangeLog: - + new setup.py for jack's modules and the cursesmodule. jack itself + still has to be manually installed. + +2003-10-12 03:54 zarne + + * README, jack, jack_config.py, jack_freedb.py, jack_functions.py, + jack_globals.py, jack_helpers.py, jack_main_loop.py, + jack_prepare.py, jack_tag.py, jack_workers.py, doc/INSTALL: - fixed + --update-freedb + + - declare encoding (newer python wants this) + + - 17_authenticated_http-proxy_support_patch + + - fixed some deprecation warnings + + - 07_continue_various_if_blank_artist + + - various bug fixes + + - added --strictly-enforce-ISO to lame options + + - fix for new cdparanoia screen output format + + - print dots while tagging (which can be time consuming, e.g. with + ID3v2) + + - 19_catch_rename_too_long_fix + + - slight documentation updates (lots of stuff still missing) + +2003-04-30 04:35 zarne + + * jack_checkopts.py, jack_config.py, jack_display.py, jack_init.py, + jack_tag.py: - ogg tags are now written as utf-8, as required by + the standard + + - cosmetic stuff + +2003-04-30 03:49 zarne + + * jack, jack_checkopts.py, jack_config.py, jack_init.py, + jack_tag.py: - id3v2 support, rejoice! you need + http://pyid3lib.sourceforge.net/ + + - small stuff + +2003-04-19 01:45 zarne + + * jack_helpers.py: - changed default lame command lines: --r3mix -> + --alt-preset standard; -h -b -> --alt-preset cbr + +2003-04-19 00:55 zarne + + * jack_config.py, jack_freedb.py, jack_functions.py, + jack_helpers.py, jack_init.py, jack_playorder.py, jack_prepare.py: + + - small bugfixes + + - nonfunctional (yet) support for the PLAYORDER field in freedb + entries + + - toc reading more robust + +2003-01-22 20:15 zarne + + * jack_helpers.py, jack_main_loop.py, jack_workers.py: - fixed + missing import signal + + - fixed signals for child processes + + - CDDB.py toc-reader now closes rip device (sf.net Bugs item + #664344) + +2003-01-22 18:40 zarne + + * jack_config.py, jack_m3u.py, jack_tag.py: - added support for + creating m3u playlist (as requested) + +2003-01-22 18:11 zarne + + * jack, jack_argv.py, jack_checkopts.py, jack_config.py, + jack_freedb.py, jack_functions.py, jack_generic.py, + jack_main_loop.py, jack_prepare.py, jack_utils.py, jack_workers.py: + - quite a number of fixes. Why did nobody complain? + +2002-09-05 00:17 zarne + + * jack, jack_checkopts.py, jack_config.py, jack_display.py, + jack_freedb.py, jack_functions.py, jack_generic.py, + jack_globals.py, jack_helpers.py, jack_main_loop.py, + jack_prepare.py, jack_t_curses.py, jack_tag.py, jack_term.py, + jack_workers.py: + + - more cleanups and bugfixes + + - out of ignorance I failed to notice that I already use python-2.2 + features. Who has problems with jack *requiring* python >= 2.2? + +2002-09-04 00:34 zarne + + * jack, jack_checkopts.py, jack_config.py, jack_freedb.py, + jack_functions.py, jack_t_curses.py, jack_term.py: + + - more cleanups + + - terminal resizing and xtermset both seem to be ok now + +2002-09-03 22:45 zarne + + * jack_readprefs.py: + + - removed unused module jack_readprefs + + - jack_generic was not modified, what is CVS trying to tell me? + +2002-09-03 21:33 zarne + + * jack, jack_argv.py, jack_freedb.py, jack_functions.py, + jack_main_loop.py, jack_utils.py, jack_workers.py: + + - cleanups + + - use error(), info() and warning() more often + +2002-09-03 19:56 zarne + + * jack, jack_argv.py, jack_checkopts.py, jack_config.py, + jack_constants.py, jack_display.py, jack_encstuff.py, + jack_freedb.py, jack_functions.py, jack_generic.py, + jack_globals.py, jack_helpers.py, jack_init.py, jack_main_loop.py, + jack_misc.py, jack_progress.py, jack_rc.py, jack_ripstuff.py, + jack_status.py, jack_t_curses.py, jack_targets.py, jack_term.py, + jack_utils.py, jack_workers.py: + + - things are taking form, ripping and renaming seems to work + + - configfile: new format, new filename. save options with --save + + - this is still unstable, beta, don't expect too much (except bugs) + +2002-09-03 10:42 zarne + + * jack, jack_argv.py, jack_checkopts.py, jack_children.py, + jack_config.py, jack_display.py, jack_freedb.py, jack_functions.py, + jack_globals.py, jack_helpers.py, jack_init.py, jack_misc.py, + jack_readprefs.py, jack_ripstuff.py, jack_status.py, + jack_t_curses.py, jack_t_dumb.py, jack_tag.py, jack_targets.py, + jack_term.py, jack_utils.py, jack_version.py, jack_workers.py, + doc/ChangeLog: + + - work on version 3.0.0 starts now + + - don't use this, only the bare minimum functionality is there + + - e.g. no config file yet + +2002-06-20 14:36 zarne + + * jack: + + - fixed a stupid variable initialisation bug + + - fixed another (hope it was the last one) append() with >1 args + bug + +2002-06-13 05:43 zarne + + * jack.man: + + - -F and -f clarified + +2002-06-13 05:37 zarne + + * jack: + + - strange that nobody noticed it, but jack couldn't rip CDs with + only one track on them. fixed. + + - some cleanups + +2002-06-09 02:06 zarne + + * jack: + + - only import what we use from the curses module + +2002-06-09 01:56 zarne + + * jack: + + - jack can use normal curses now (to the extent possible, i.e. + without reacting to SIGWINCH (terminal window resizing)) (inspired + by Oleg Broytmann's patch, thanks!) + +2002-06-01 17:03 zarne + + * jack: + + * added sloppy ripping mode which is activated by a secret switch + +2002-05-25 04:01 zarne + + * jack: + + * to my understanding FLAC produces VBR files. now jack thinks so, + too. + +2002-05-25 03:42 zarne + + * jack: + + * added support for MPEGplus (encoder: mppenc, extension: .mpc) + +2002-05-25 01:46 zarne + + * jack.man: + + * typo + +2002-05-25 01:44 zarne + + * jack.man: + + * (hopefully) clarify how the -R / --rename option works + +2002-05-25 01:36 zarne + + * jack: + + * nobody complained, but I re-added --rename-only with a + deprecation warning + +2002-05-25 00:56 zarne + + * jack, jack.man: + + * renamed option --rename-only to --rename -- old name was + confusing. I'll revert this if enough people complain. + +2002-05-24 15:51 zarne + + * jack: + + * --quality switch for vbr, thanks to Michael Banck for the patch! + +2002-05-24 14:17 zarne + + * jack: + + * small changes to the flac patch + +2002-05-24 14:15 zarne + + * jack: + + * flac patch from Drew Hess - thanks, great work! + +2002-05-24 12:12 zarne + + * jack: + + * hide --charset option from --help if char_filter is not used. + having no effect, it would then only confuse people. + +2002-05-24 12:10 zarne + + * jack: + + * some small cleanups, options reordered + + * new char_filter, e.g. for upper->lowercase conversion. should + work with any character encoding + + * new option --charset, see above, default is latin-1 + + * needs python >= 2.2; can anybody tell me how to do this in python + < 2.2? + +2002-05-04 04:55 zarne + + * jack: + + * fixed Debian Bug#140903 (replacement_chars doesn't work on + uppercase umlauts) by documenting it - there's no way to "fix" it + but the workaround is simple: just add the umlauts explicitly to + unusable_chars and replacement_chars + +2002-05-03 00:03 zarne + + * jack: + + * fixed Debian Bug#141781: --upd-progress assumes that the tracks + are encoded in mp3 format, even if the encoder is oggenc + +2002-04-30 01:36 zarne + + * jack: + + * Debian Bug#144996 (jack uses ogg tag "YEAR" instead of "DATE") + fixed. + +2002-04-17 11:55 zarne + + * jack: + + * upped version to 2.99.9 + + * switch from FCNTL to fcntl module + +2002-04-16 09:28 zarne + + * jack.man, doc/ChangeLog: + + * added one example to the manpage + + * ChangeLog isn't auto-updated currently, will fix soon + +2002-04-15 04:49 zarne + + * jack: + + * update copyright notice, welcome to the year 2002 + +2002-04-15 04:40 zarne + + * jack: + + * elaborate on the missing permissions for the device problem many + people have + +2002-04-15 03:27 zarne + + * jack: + + * when guess-tocing WAVs you now have the option to truncate them + if they are noch CDDA-block aligned + + * better defaults for genre and year when pre-tagging + +2002-04-15 02:23 zarne + + * jack: + + * (re-)enabled correct processing of mixed mode CDs (which have a + data track 1) + + * rewrote and improved toc-reader based on cdda2wav + + * corrected an assumption in CDDB.py's toc-reader which thought the + first track is always numbered 01 + +2002-04-15 00:32 zarne + + * jack: + + * fixed bugs introduced in rev. 1.42 + + * made CD-EXTRA really work ;) + +2002-04-14 19:36 zarne + + * jack, jack.man: + + * fixed bugs.debian.org/132985 by accepting patch from Martin + Michlmayr + +2002-04-14 18:23 zarne + + * jack: + + * fixed errors ripping CD-EXTRA by double checking the TOC CDDB.py + reports against what the ripper thinks + +2002-02-12 17:25 zarne + + * jack: + * "various" is now a global variable + + * on VA CDs the artist is now shown while encoding (thanks to + Martin Michlmayr) + +2002-02-11 03:54 zarne + + * jack: + * removed the quality switch for oggenc, people say the default (3) + is good. In a quick listening test with a difficult CD I could not + spot any obvious flaws. Ogg Vorbis is impressive. + +2002-02-06 20:18 zarne + + * README, jack, jack_CDTime.py, jack_TOC.py, jack_TOCentry.py, + jack_misc.py, jack_mp3.py, setup-cursesmodule.py, setup-jack.py, + cursesmodule/README.precompiled, doc/download.html, + doc/examples.html, doc/faq.html, doc/index.html, doc/install.html, + doc/links.html, doc/requirements.html, doc/screen.html, + doc/todo.html, doc/usage.html: + * I prefer jack related email to zarne@users.sf.net now, thanks. + +2002-02-06 20:06 zarne + + * jack.man: * corrections + + * missing options added (by Michael Banck, thanks.) + +2002-02-06 18:48 zarne + + * jack: + * use LC_ALL=C, I hope this helps solve the remaining problems with + localization + +2002-02-04 01:17 zarne + + * jack.man: + * Michael Banck is too modest get have credits for the manpage. + +2002-02-03 18:08 zarne + + * jack: + * sendmail is now called as /usr/lib/sendmail. Does anyone still + use mailsubmit? + +2002-02-03 16:57 zarne + + * jack.man: + * some edits/corrections/additions + +2002-02-03 16:56 zarne + + * jack.man: + * initial checkin of the manpage Michael Banck has written for jack + +2002-02-03 15:47 zarne + + * jack: + * added -QQ which is like -Q but allows you to continue on failed + queries. + +2002-02-03 15:19 zarne + + * jack: + * fixed freedb submission by email (I hope, didn't test it) + +2002-02-03 15:04 zarne + + * jack: + * pretagging now allows setting of genre (%g) and year (%y) + + * changed mnemonic for generic_device from %g to %D -- check your + .jackrc! + +2002-02-03 14:31 zarne + + * jack: + * workaround for bug in ID3.py which defaults the genre to Blues + [0] + +2002-02-03 14:09 zarne + + * jack: + * jack now creates directories even when reading --from-tocfile + +2002-02-03 13:31 zarne + + * jack: + * Linux OSTYPE is now recognized if it's called linux-gnu (thank + you dme!) + +2002-02-03 13:14 zarne + + * jack: + * fixed a bug in VA pretagging, thanks to Martin Michlmayr for the + patch! + +2002-02-03 03:48 zarne + + * jack: + * implemented ogg post-tagging for pyvorbis >= 0.5, for real this + time ;-) + + * fixes for local freedb_dir by Matthew Mueller + +2002-02-03 03:20 zarne + + * jack: + * increased status_blocksize from 56 to 64 for oggenc. + + * implemented ogg post-tagging for pyvorbis >= 0.5, thanks to + Michael Banck! + + * oggenc is now called with -q 5 instead of a bitrate parameter. + True VBR now. + + * [ Sorry, I was terribly busy in the recent past. ] + + * [ There's still a huge backlog.] + +2001-11-12 06:36 zarne + + * jack: + - small code cleanup (the category chooser is one function now + instead of 3 instances) + + - freedb category is now remembered, useful for submitting updated + entries + + - bug fixed: entering "0" as category used last category instead of + aborting + +2001-11-09 19:34 zarne + + * jack: + - added option --wait (wait on quit) + + - added option --workdir (where to put files / dirs, == base_dir) + + - added option --search (where to search for workdir, appends to + searchdirs) + + - create all dirs leading to workdir + +2001-11-08 19:57 zarne + + * jack: + This patch - provided by Martin Michlmayr - does this: + + - use float and int instead of atof and atoi. The latter are + deprecated (see Python documentation). (The jack_*.py modules need + to be overhauled likewise) + + - Check if an input string is really an integer and don't fail if + it's not. + + - Check the range of tracks in the -t arguments and ignore invalid + tracks. + +2001-11-08 02:22 zarne + + * jack: + now that 2.99.7 is out, bump version to 2.99.8 + +2001-11-08 02:20 zarne + + * jack, setup-cursesmodule.py, cursesmodule/jack_cursesmodule.c, + doc/ChangeLog, doc/INSTALL: + - get rid of compiler warnings with -Wno-strict-prototypes + + - put the two unused functions which gcc complains about to use + +2001-11-07 18:52 zarne + + * doc/: ChangeLog, index.html: + - index.html points to ChageLog instead of CHANGELOG now + + - ChangeLog will contain the more recent changes now, CHANGELOG the + very old ones. ChangeLog will NOT be up-to date in cvs BUT in + releases. + +2001-11-07 18:43 zarne + + * doc/CHANGELOG: - prepared it for automatic actualization, + released versions contain the CVS log from now on. CHANGELOG is now + a template from which ChangeLog is generated when releasing, CVS + will contain both in a undefined state. + +2001-11-07 18:08 zarne + + * jack: - version is now 2.99.7 + + - use termios instead of TERMIOS to make python2 happy + + - works with python2 now, I tested/use 2.1.1 + + - tell people what to do if modules are missing + + - re-organized .jackrc, unfortunately everybody has to re-gen it + now + + - with luck, this is the last time everybody has to re-gen it :) + + - tried xtermset again and found that it still works + + - try it! + + - updated gogo helper, thanks to José Antonio Pérez Sánchez + + - compile helpers, this works in python2. comment out if you have + problems. + + - changed the execs to make python2 happy + + - encoders, rippers and freedb servers are listed if specified + doesn't exist + + - we're close to 3.0 + +2001-11-07 18:08 zarne + + * README: removed version, I keep to forget to update it + +2001-10-11 00:38 zarne + + * README, jack, doc/INSTALL: - fixed "tag" info for Ogg/Vorbis + + - fall back to CBR if selected encoder does not support VBR + (thanks to Michael Banck for finding both issues) + + - removed version info from doc/INSTALL because I keep to forget to + update it + +2001-10-10 23:21 zarne + + * jack: - changed http Submit-Mode from test to submit (oops) + +2001-10-10 21:57 zarne + + * jack: - Version is now (since 2 commits actually) 2.99.6 + + - cursesmodule was renamed to jack_cursesmodule to avoid conflicts + + - re-organized .jackrc + + - fixed freedb-sources + + - default encoder is now oggenc (which can only do vbr) + + - default naming scheme has been changed to "Artist - Album - 01 + - Tracktitle.[ext]" + + - fixed resizing (more precisely I removed a hack which made it + work for me on RedHat 6.2) + + - workaround for illegal freedb entries with empty album name + +2001-10-10 18:43 zarne + + * doc/TODO: Todo: write get_toc for ogg/vorbis + +2001-10-10 18:39 zarne + + * README: - state that oggenc is now the default + +2001-10-10 18:34 zarne + + * cursesmodule/: cursesmodule.c, jack_cursesmodule.c: - renamed + cursesmodule.c -> jack_cursesmodule.c + + - patched the module to reflect this change + +2001-10-10 18:33 zarne + + * cursesmodule/precompiled/Debian-Woody/jack_cursesmodule.so: + jack_cursesmodule, precompiled on Debian-Woody + +2001-10-10 18:29 zarne + + * setup-cursesmodule.py, cursesmodule/README.precompiled, + doc/CHANGELOG, doc/INSTALL, doc/TODO: + - Version is now (since 2 commits actually) 2.99.6 + + - cursesmodule was renamed to jack_cursesmodule to avoid conflicts + + - the URL in CHANGELOG has been fixed (missing www.) + + - updated TODO + + - re-organized .jackrc + + - fixed freedb-sources + + - default encoder is now oggenc (which can only do vbr) + + - default naming scheme has been changed to "Artist - Album - 01 + - Tracktitle.[ext]" + + - fixed resizing (more precisely I removed a hack which made it + work for RedHat 6.2) + +2001-10-06 07:14 zarne + + * jack: fixed the bug which prevented successful ogg tagging + (Bender, you really should not program when you're sober!) + +2001-10-06 00:14 zarne + + * README, jack: + started Ogg Vorbis support which seems to work, there's still a bug + concerning the ogg info data. I'll try to fix that one later. + + Jack can now be extended to use any target format. + +2001-08-31 22:27 zarne + + * README, doc/INSTALL: + clarified (I hope) the installation procedure + +2001-08-31 06:29 zarne + + * ID3.py, cursesmodule-1.5b2.patch: + ID3 is available separately, the patch was moved into the + cursesmodule subdir. + +2001-08-31 06:26 zarne + + * setup-cursesmodule.py, setup-jack.py: + inital checkin. anyone else I forgot? + +2001-08-31 06:20 zarne + + * cursesmodule/: Makefile, Makefile.pre, Makefile.pre.in, + README.cursesmodule, README.precompiled, Setup, config.c, + cursesmodule-1.5b2.patch, cursesmodule.c, lifedemo.py, sedscript, + precompiled/RedHat-6.0/cursesmodule.so: + initial checkin, the patched cursesmodule is now part of the + standard dist. + +2001-08-31 06:16 zarne + + * cursesmodule/precompiled/Debian-Potato/cursesmodule.so: + initial checkin + +2001-08-31 06:09 zarne + + * jack, jack_TOCentry.py, jack_mp3.py, doc/INSTALL: + * bumped version to 2.9.5 + + * include my patched cursesmodule now, together with a distutils + installer + + * removed ID3.py, this and CDDB.py must be downloaded and installed + separately (instructions included) + + * runs on python2 again, don't know whether it works + + * lots of changes, fixes -- I lost track + +2001-03-14 07:32 zarne + + * jack_mp3.py: Why hasn't this been in CVS before??? :] + + - huge performance gain + + - better (more accurate) frame syncing (two consecutive rames are + searched for now) + + - more robust now + + - VBR bitrates are now returned as a float + + - preliminary ID3v2 support (corrently only the version number is + extracted and the tag is skipped) + + - new info: bpf and framesize + + - better detection of Xing tags + +2001-03-14 07:23 zarne + + * ID3.py: - small fixes + + - replaced tabs by spaces + + - this is not a official version now, I will sync this with + official 1.0 soon. + +2001-03-14 07:19 zarne + + * README, jack, doc/INSTALL: - support for freedb files which have + track title or artist stored in the EXTT fields + + - toc reading for cdparanois disabled because it's incomplete for + CD EXTRA + + - added support for CDDB.py, available at + http://cddb-py.sourceforge.net/ (currently only toc reading) this + is now the default + + - fixed a bug triggered by tocfiles containing quotes on the file + name + + - added support for EXDD=YEAR: ID3G, who can tell me who set this + "standard"? + + - CRs are now ignored in freedb files + + - added "Sampler" and "Diverse" to the list of various artists + tokens + + - -G none now sets the ID3v1 genre to 255("unknown") + + - print year and genre when finished (if available) + +2000-11-21 02:47 zarne + + * jack: *** .jackrc option to disable http_proxy *** replace x -> × + for speed factors *** sys.stdin.flush() removed, impossible :-). + What's the "correct" way to flush stdin? fcntl with O_NONBLOCK, + then reading (and discarding) until nothing is read? Is there an + easy way? *** jack.freedb now has as many spaces in front of the + MSF offsets as your favorite CD player *** some reformatting + +2000-11-02 20:27 zarne + + * jack: 1) reformatted helpers{} 2) show_time = 1 and show_names = + 1 are now defaults 3) it's now called 2.99.4 (actually since the + last commit) + +2000-11-02 02:08 zarne + + * jack: 1) renamed id -> cd_id; id is a reserved word in python. + 2) ignore data tracks, tested with cdparanoia only 3) quit if there + are no audio tracks (to do) 4) --abort-on-skip is now the default + for cdparanoia, change it if you don't like it 5) call it 2.99.4 + + cosmetic changes: 1) more straighforward displays 2) show_time now + saves space by reducing track_names to their number. Thus the + "normal" line for a track fits into 80 columns again. 3) Show + freedb-id and total playing time in Options line 4) try to show + Options line when exiting + + "do only one change per commit" is for sissies :-). + +2000-08-13 20:16 zarne + + * jack: forgot this one in the previous commit + +2000-08-13 20:13 zarne + + * README, doc/CHANGELOG, doc/examples.html: fixed some strings to + indicate that freedb now supports entry submission with HTTP POST + (option --submit) + +2000-08-13 19:26 zarne + + * jack: added a check for an existing destination directory + +2000-08-11 03:24 zarne + + * jack: added WAV to the file types --guess-toc recognizes + internal: progress now also takes a tuple containing the args + +2000-08-11 00:02 zarne + + * jack: changed the short option for --update-freedb from -u to -U + because of conflicts. Thanks to C. Marquardt for finding what I do + when I program late at night :-). + +2000-08-09 04:52 zarne + + * ID3.py, jack: jack can now "update", i.e. re-generate freedb + files (new option -u) updated ID3 module so that it supports + ID3v1.1 track info jack now sets ID3v1.1 track info + +2000-08-08 08:17 zarne + + * jack: added xing vbr tag decoding. Not used much yet, but -g now + works on vbr mp3s + +2000-08-08 01:32 zarne + + * jack: fixed for new versions of gogo; vbr display enhancements + and cosmetics + +2000-06-28 02:23 zarne + + * jack: fixed a misleading error message + +2000-06-26 16:12 zarne + + * doc/faq.html: Added one FAQ entry, fixed one typo. + +2000-06-21 01:23 zarne + + * jack: fixed (cosmetic) display bug when using image-file + +2000-05-11 16:51 zarne + + * jack: update to my current development version + +2000-05-11 16:32 zarne + + * ID3.py, README, jack, cursesmodule-1.5b2.patch, jack_CDTime.py, + jack_TOC.py, jack_TOCentry.py, jack_misc.py, doc/faq.html, + doc/gpl.txt, doc/index.html, doc/install.html, doc/screen.html, + doc/jack-logo.jpg, doc/requirements.html, doc/usage.html, + doc/download.html, doc/examples.html, doc/jack-screen.gif, + doc/download.gif, doc/main.gif, doc/requirements.gif, + doc/screen.gif, doc/usage.gif, doc/install.gif, doc/links.gif, + doc/links.html, doc/CHANGELOG, doc/anim.written.in.vi.gif, + doc/mine.css, doc/INSTALL, doc/jack-curses-screen.gif, doc/TODO, + doc/todo.html: initial import of jack-2.99.0-pre + +2000-05-11 16:32 zarne + + * ID3.py, README, jack, cursesmodule-1.5b2.patch, jack_CDTime.py, + jack_TOC.py, jack_TOCentry.py, jack_misc.py, doc/faq.html, + doc/gpl.txt, doc/index.html, doc/install.html, doc/screen.html, + doc/jack-logo.jpg, doc/requirements.html, doc/usage.html, + doc/download.html, doc/examples.html, doc/jack-screen.gif, + doc/download.gif, doc/main.gif, doc/requirements.gif, + doc/screen.gif, doc/usage.gif, doc/install.gif, doc/links.gif, + doc/links.html, doc/CHANGELOG, doc/anim.written.in.vi.gif, + doc/mine.css, doc/INSTALL, doc/jack-curses-screen.gif, doc/TODO, + doc/todo.html: Initial revision + diff --git a/doc/INSTALL b/doc/INSTALL new file mode 100644 index 0000000..fcc48e7 --- /dev/null +++ b/doc/INSTALL @@ -0,0 +1,87 @@ +### This is jack (c) 1999-2004 Arne Zellentin +### free to use, no warranties, no nothing +### see COPYING + + +--- Step 1 - install 3rd party modules --------------------------------------- + +install the eyeD3 and CDDB.py modules: + +* grab them from http://cddb-py.sourceforge.net + and http://eyed3.nicfit.net/ + +Too ease up the installations, install the Python Distutils +from + + http://www.python.org/sigs/distutils-sig/ + +if you don't already have them. (If you don't have them you'll get errors like +"ImportError: No module named distutils.core".) + +* if you have the python distutils installed, simply install them (as root) + with + + # python setup.py install + +* if not, follow the instructions + + +--- Step 2 - install the jack_* modules and my curses module ----------------- + +* see the end of this file for tips on installing it without distutils! + +* if you have the python distutils installed, run (as root if needed) + + # python setup.py install + +--- Step 3 - install jack ---------------------------------------------------- + +Copy it somewhere in your $PATH, e.g.: + + # cp jack $HOME/bin + +or (you may have to be root) + + # cp jack /usr/local/bin/ + +--- That's it -- you're done! Congratulations! + + + +------------------------------------------------------------------------------ +--- help on installing the cursesmodule manually ----------------------------- +------------------------------------------------------------------------------ + +(some of this is outdated, the module is now called jack_curses) +If you want to use the curses mode (belive me, you want to), you have to +install a special cursesmodule. The one which comes with python has no support +for pads. The improved version from Oliver Andrich is missing the function +resizeterm which I patched in. I mailed the patch to the author so it may be +included in a future version. Get my version on the download page or download +the original cursesmodule from +http://andrich.net/python/selfmade.html#ncursesmodule (link broken, sorry) +and use the patch in the cursesmodule directory (cursesmodule-1.5b2.patch). You +can either compile the module yourself or use the precompiled version which is +in my package. I compiled it on a RedHat 6.0 (late I added a binary which runs +on Debian Potato) alike system on an i686. If you want to (or have to) compile +it yourself, try the following if you can't get the Makefile to work: + +# gcc -g -O2 -I/usr/local/include/python1.5 -I/usr/local/lib/python1.5/config \ +# -DHAVE_CONFIG_H -c ./cursesmodule.c +# gcc -shared cursesmodule.o -lncurses -ltermcap -o cursesmodule.so + +Install the cursesmodule.so to your site-packages. + +If you can't get the precompiled cursesmodule to run, make sure that all +needed libraries are installed on you system. Check this with +# ldd cursesmodule.so +which should produce output similar to + libncurses.so.4 => /usr/lib/libncurses.so.4 (0x40018000) + libtermcap.so.2 => /lib/libtermcap.so.2 (0x4005a000) + libc.so.6 => /lib/libc.so.6 (0x4005e000) + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x80000000). +All links must be satisfied; if a library cannot be found, ldd will tell you. +In this case install all missing libraries. Some Linux systems don't install +termcap libraries, fix this; e.g. on RedHat systems, you need +libtermcap-*.rpm. + diff --git a/doc/TODO b/doc/TODO new file mode 100644 index 0000000..2492f36 --- /dev/null +++ b/doc/TODO @@ -0,0 +1,12 @@ +#/\# TODO: +#\/# - replace df call by something more portable *DONE* +# - check freedb submit line-length *DONE in -U* +# - get alternate freedb sites, ... *HALF-DONE, static list* +# - more DAE tools and encoders *DONE* --- anything else? +# - gtk-frontend, anyone? +# - make toc-file reading more robust 1/2 *DONE (uses CDDB.py now)* +# - make image-reader otf capable +# - create a man page +# - a function to query all unqueried rips would be nice... *DONE* +# - preallocate discspace +# - write get_toc for ogg/vorbis diff --git a/doc/anim.written.in.vi.gif b/doc/anim.written.in.vi.gif new file mode 100644 index 0000000..98289d7 Binary files /dev/null and b/doc/anim.written.in.vi.gif differ diff --git a/doc/download.gif b/doc/download.gif new file mode 100644 index 0000000..359c01c Binary files /dev/null and b/doc/download.gif differ diff --git a/doc/download.html b/doc/download.html new file mode 100644 index 0000000..8955d65 --- /dev/null +++ b/doc/download.html @@ -0,0 +1,131 @@ + + +Download Jack + + + + +
+ + + + + + + +
+ + +
+

Download Jack

+		 +Jack
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Description + Version + Location +
upcoming version without up-to-date documentation, read INSTALL! + 2.99.0-pre + jack-2.99.0-pre.gz +
upcoming version without up-to-date documentation + 2.2.5-pre + jack-2.2.5-pre.tar.gz +
buggy version without up-to-date documentation + 2.2.4-pre + jack-2.2.4-pre.tar.gz +
interim version without up-to-date documentation + 2.2.3-pre + jack-2.2.3-pre.tar.gz +
old version without up-to-date documentation + 2.2.2-pre + jack-2.2.2-pre.tar.gz +
current stable + 2.2.0 + jack-2.2.0.tar.gz +
older version, small bugs + 2.1.0 + jack-2.1.0.tar.gz +
old buggy version + 2.0.1 + jack-2.0.1.tar.gz +
buggy version + 2.0.0 + jack-2.0.0.tar.gz +
older version + 1.3.5 + jack-1.3.5.tar.gz +
older version + 1.3.4 + jack-1.3.4.tar.gz +
older version, known bugs. + 1.3.3 + jack-1.3.3.tar.gz +
older version + 1.3.2 + jack-1.3.2.tar.gz +
older version + 1.3.1 + jack-1.3.1.tar.gz +
current BETA + - + - +
current ALPHA (just the script) + varies + jack.gz +
cursesmodule patched for Jack, includes precompiled shared binary + 1.5b2 + cursesmodule-with-resizeterm-1.5b2.tar.gz +
+ +

+Wanna go home or on to the installation information? +

+ + +
+© Arne Zellentin, +zarne@users.sf.net +
+(changed: 10-Jan-2000) + + + + + diff --git a/doc/examples.html b/doc/examples.html new file mode 100644 index 0000000..8d56401 --- /dev/null +++ b/doc/examples.html @@ -0,0 +1,96 @@ + + +Jack application examples + + + +
+ + + + + + + +
+ + +
+

Application examples

+		 +Jack
+ +
    +
  • Insert a CD, fire up jack:
    +$ jack
+
    +Now watch it work. It's fun for a while. After having finished, you have +the follwing files on your HD: track_01.mp3, track_02.mp3, ..., track_nn.mp3 + plus jack.toc, jack.freedb, jack.progress. The last three are used to +store the state jack is in so it can resume work when interrupted. +
  • Jack will create a directory called jack-xxxxxxxx for you, there it +stores all the file for the CD whose id is xxxxxxxx. After a freedb query this +directory is renamed to something human readable, like "Artist - Title". +
  • When jack is interrupted, call it again using the same commandline as before to resume work, in this case: +
    $ jack
    +
  • The WAV files have been deleted. If you want jack to keep them, try +
    $ jack -k
    +
  • Now let's try a freedb query: +
    $ jack -q
    +when succesful the files are now renamed to something more readable and have been ID3 tagged accordingly. jack.freedb contains the queried freedb entry, the original file has been backed up to jack.freedb.bak. +
  • The query failed? Ok, contribute! edit the freedb template: +
    $ vi jack.freedb
    +Note: the DTITLE should be set to +
    Artist / Name Of Album
    +or +
    Various Artist / Name Of Compilation
    +when adding a compilation, use +
    Artist - Title Of Track
    +for the track titles. Do not delete any lines from the template. Do not change the numbers. Yes the TTITLEs start at 0 and end one track too early. Read the freedb documentation. +
  • now activate the entries: +
    $ jack -R
    +now the files have been renamed and tagged. Check the names two or three times. +Typo made? No problem, you can alway undo the file renaming with +
     $ jack -u
    +Note that the ID3 tags are not undone. Fix the freedb file and again, use +
    $ jack -R
    +to activate your changes. +When you are sure the freedb file is suitable for submission, submit it (via +e-mail (option -m) or via HTTP POST (option --submit). When using the former, +sendmail must be installed and working on your machine! If you're on a dial-up, +you can use the -m option to queue submits, provided sendmail is set up +accordingly): +
    $ jack -m
    +or +
    $jack --submit
    +
+Those were the basics. Now some more advanced examples: +
    +
  • All in one: query, rip, encode, cleanup: +
    $ jack -Q --remove
    +
  • query any time while working: +
    $ jack
    +and, from another shell: +
    $ jack -d -Q
    +
  • query for unknown MP3s: +
    $ jack -q -g track_*.mp3
    +
  • rip from image, first, create the image: +
    $ cdrdao read-cd --datafile data.cdr data.toc
    +then make MP3s from the image: +
    $ jack -f data.toc
    +
+more to follow. +

+Wanna go home? + +

+ + +
+"All trademarks are owned by their owners" or whatever I have to state.
+© Arne Zellentin, +zarne@users.sf.net +
+(changed: 19-Aug-99) + + diff --git a/doc/faq.html b/doc/faq.html new file mode 100644 index 0000000..f0ec5b7 --- /dev/null +++ b/doc/faq.html @@ -0,0 +1,75 @@ + + +FAQ for Jack + + + +
+ + + + + + + +
+ + +
+

Frequently Asked Questions

+		 +Jack
+ +
    +
  • Q: I'm compiling python 1.5.2 from source. What modules/options do I + need to use? +

    +A: Use the '--with-threads' flag to configure, and make sure you include + the termios module (which is disabled by default) by uncommenting + the line:
    + + #termios termios.c # Steen Lumholt's termios module +
    + in Modules/Setup. Jack 2.x doesn't need the threads any more, but they +are still good to have. Only leave them out if they cause trouble. In general, I recommend activating as many modules as possible so you don't have to +recompile every time a newly installed programm needs another non-default module. +(from Jason Lunz) +

    +

  • Q: I can't / don't want to install python-1.5.2. Isn't there a + way to have jack work with an older version of python? +

    + A: There are bugs in the python-1.5.1 modules that prevent jack + from working flawlessly. From memory, the urllib contained a bug + which prevented freedb queries from working from behind a proxy. + The wave module did something stupid, too (it is needed for + ripping from an image.) If you need neither, try it out and tell + me what works. Otherwise you may try to replace these modules + by the ones from the python-1.5.2 version. Again, please tell me + your experiences. +

    +

  • Q: Jack is encoding with a different bitrate than specified in .jackrc. Why? +

    +A: The bitrate is cached in jack.progress. So if you encode track n with bitrate x1, delete the MP3 and call jack without specifying a bitrate, bitrate x1 is used, regardless what the default in your .jackrc is. Specify the wanted bitrate with -b. +

    +

  • Q: I want to use a flat local cddb directory. Jack wants me to use subfolders like rock, blues, ... . Can you help? +

    +A: As long as nobody complains, use this workaround (sh style):
    +cd [your_cddb_dir]
    +for i in blues classical country data folk \
    +jazz misc newage reggae rock soundtrack ; do
    + ln -s . "$i"
    +done +

    +

+Wanna go home? + +
+ + +
+© Arne Zellentin, +zarne@users.sf.net +
+(changed: 19-Jul-99) + + diff --git a/doc/gpl.txt b/doc/gpl.txt new file mode 100644 index 0000000..d104746 --- /dev/null +++ b/doc/gpl.txt @@ -0,0 +1,340 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc. + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Library General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Library General +Public License instead of this License. diff --git a/doc/index.html b/doc/index.html new file mode 100644 index 0000000..88dfcef --- /dev/null +++ b/doc/index.html @@ -0,0 +1,177 @@ + + +Homepage of Jack + + + + +
+ + + + + + + +
+
+
Jack Logo
+

"Why would anyone need another CD ripper / MP3 encoder frontend?"

+If you just need everything that is new, download it here. Be sure to read the system requirements. It's quite likely that you do not have the correct python version. +

+News: + + + + +
10-Jan-2000 + New Version (2.99.0-pre) "ain't it dead yet". I'm about to do some major + restructuring on jack, i.e. breaking it up into modules, so the + installation has changes slightly. Read INSTALL. Cdparanoia 9.7 is now + supported, so is xingmp3enc (the latter being untested). You can now use + a local freedb dir. Yes, all bugs fixed, especially those concerning + the image-reader. TOC file reading has been completely rewritten, it + is now 100% bug-free (as if). Please, everybody try this version and + gimme some feedback. +
05-Nov-1999 + New Version (2.2.5-pre). Still no documentation updates. Fixes + 2.2.4's renaming bug. Doh. +
04-Nov-1999 + New Version (2.2.4-pre). No documentation updates (again). Two bugs + fixed, one newly introduced. "desperate" mode for those who can't get curses mode to work. + Jack now has 3333 lines of code. +
04-Nov-1999 + New Version (2.2.3-pre). No documentation updates (again). Reintroduced + free space checking by calling df for all those (RedHat?) users who + had an error with statvfs. Whoever built those rpms should be punished. + rename_underscore has been replaced by something more flexible, now you + can replace characters by multiple characters (like "ä" to "ae"), + kill characters from the filename to be used and, of course, replace + those spaces by underlines. + New DAE tools: cdda2wav (finally!) and dagrab (untested as it doesn't + like my Plextor). All bug fixed, of course. +
22-Oct-1999 + New Version (2.2.2-pre). If you get an error like + "AttributeError: TIOCWINSZ", try this version. It is shipped + with 2.2.0 documentation as I didn't have time to update it yet. + Changes: all bugs fixed :), new features. Wait for the final version + for details. +
19-Aug-1999 + New Version (2.2.0). New curses mode, looks much better, scroll + through the status screen if it doesn't fit in your terminal. + I recommend not to use XTermset any longer as it is no longer needed. + The usual bugfixes are there, too, check the + changelog. +
18-Aug-1999 + I really want to add support for the Xing encoder. Does anyone want to pay the registration fee for me? It's only $19 I think. +
09-Aug-1999 + New Version (2.1.0), all bugs fixed (of course!), new features like + on-the-fly operation. +
19-Jul-1999 + Big OOPS. Version 2.0.0 contained (at least) two "brown paper bag" bugs: + first, jack tried to chdir into newly created dirs twice (one time too + much), this gets you the "could not create or change to..." error. + Second, the dirs were created in the wrong sequence, so instead + of "artist/album" you get "album/artist". Upgrade to 2.0.1, get it + from the download page. +
16-Jul-1999 + None of the beta testers complained, so I released version 2.0.0. + Much has changed, most notably I restructured the beast a bit so that + Jack no longer needs threads. It's now much easier to get it to work. + Jack should (finally!) run on FreeBSD and most other unices. + Jack can now create (and name according to freedb data) directories. +
01-Jul-1999 + Released version 1.3.5. Support for tosha(gettoc&DAE) has been added, + a few non-critical bugs have been fixed. +
29-Jun-1999 + Released version 1.3.4. Version 1.3.3 contained a bug where it could + wrongly claim that you inserted the wrong CD if track 01 doesn't start + at block 0. The TOC file format changed, too, so better have them + re-generated. +
27-Jun-1999 + Released version 1.3.3. see the changelog for details +
+ rearranged the pages a bit. I know the layout still sux, if you have time to waste, let me know. +
+

What's it all about?

+Jack has been developed with one main goal: making MP3s without having to +worry. There is nearly no way that an incomplete rip goes unnotices, e.g. jack +compares WAV and MP3 filesizes when continuing from a previous run. Jack also +checks your HD space before doing anything (even keeps some MB free). +

+You can take a look at jack working, there are even some explanations. +

+Jack is different from other such tools in a number of ways: +

    +
  • it is written in python + +
  • it is very configurable, maybe too much :) + +
  • it doesn't need X (but is better with it) + +
  • it can "rip" virtual CD images like the ones created by cdrdao + +
  • when using cdparanoia, cdparanoia's status information is displayed for all +tracks, so you can see if something went wrong (I consider this very important +- no one wants uncorrected errors or skips to go into one's MP3s. 'Tis the main + reason why I don't use something beautiful like grip) + +
  • it allows for overlapping ripping / encoding: when the first track has been +ripped, it's encoder is started as well as the second track's ripping process, +this "read-ahead" is of course configurable, you can have it read the whole CD +and start with the next one as the first one is beeing encoded + +
  • in on-the-fly mode, no WAVs have to be created, less space is wasted. I only recommend this if your encoder is nearly as fast as your ripper. + +
  • it uses sophisticated disk space management, i.e. it schedules it's ripping +/ encoding processes depending on available space. Jack tells you if the batch +will not fit on your HD. If you want, you can have it choose the optimal +sequence of tracks - great if you're low on HD space + +
  • freedb query, file renaming and id3 tagging - I know that this alone is not +special, but jack tries hard to recognize artist and title when working on a +"Various Artists"-CD, so that the ID3 tag can be set correctly. + +
  • it can resume work after it has been interrupted. If all tracks have been +ripped, it doesn't even need the CD anymore, even if you want to do a freedb +query. In practice, this means that you can change the CD and start another +instance of jack. + +
  • it can do a freedb query based on MP3s alone, like if you don't remember +from which CD those MP3s came from. + +
+ +Of course, all other "obvious" features are included, too: +
    +
  • being GPL'ed + +
  • different rippers and encoders are supported + +
  • freedb submissions + +
  • proxy support via http_proxy environment variable (e.g. export http_proxy=http://cache.sld.tld:3128/) + +
+ +You may want to read more on intallation and usage. +
Because it is not just "point-and-click" I put up some examples. +
Perhaps you want to know what Jack has todo. +
For your amusement, read the FAQ! +

+Please send feedback to the address below. Yes I wanna hear about all the typos I've made. +

+ +

+ +
+"All trademarks are owned by their owners" or whatever I have to state.
+© Arne Zellentin, +zarne@users.sf.net +
+(changed: 10-Jan-2000) + + + diff --git a/doc/install.gif b/doc/install.gif new file mode 100644 index 0000000..7301a6a Binary files /dev/null and b/doc/install.gif differ diff --git a/doc/install.html b/doc/install.html new file mode 100644 index 0000000..0506460 --- /dev/null +++ b/doc/install.html @@ -0,0 +1,53 @@ + + +Jack installation instructions + + + + +
+ + + + + + + +
+ + +
+

Installation instructions for Jack

+		 +Jack
+ +
    +
  • download jack. +
  • uncompress it: 
    $ gunzip jack-*.tar.gz
    +
  • untar it: 
    $ tar xvf jack-*.tar
    +
  • change directory: 
    $ cd jack-*
    +
  • follow instructions from file "INSTALL" +
  • if this is your first installation of jack, run it once, it will create a new personal preferences file in your homedir +
  • customize it using your favorite editor: +
    $ vi $HOME/.jackrc
    +
  • you may want to enable proxy support via the http_proxy environment +variable +
    $ http_proxy=http://cache.sld.tld:3128/
+$ export http_proxy
    +This is a great addition to your .bashrc or whatever you are using! +
+Wanna go home or on to the usage information? + +
+ + +
+© Arne Zellentin, +zarne@users.sf.net +
+(changed: 19-Aug-99) + + + + + diff --git a/doc/jack-curses-screen.gif b/doc/jack-curses-screen.gif new file mode 100644 index 0000000..351675e Binary files /dev/null and b/doc/jack-curses-screen.gif differ diff --git a/doc/jack-logo.jpg b/doc/jack-logo.jpg new file mode 100644 index 0000000..ad7c424 Binary files /dev/null and b/doc/jack-logo.jpg differ diff --git a/doc/jack-screen.gif b/doc/jack-screen.gif new file mode 100644 index 0000000..c03c864 Binary files /dev/null and b/doc/jack-screen.gif differ diff --git a/doc/links.gif b/doc/links.gif new file mode 100644 index 0000000..555d09b Binary files /dev/null and b/doc/links.gif differ diff --git a/doc/links.html b/doc/links.html new file mode 100644 index 0000000..a232fc9 --- /dev/null +++ b/doc/links.html @@ -0,0 +1,81 @@ + + +Jack-related links + + + +
+ + + + + + + +
+ + +
+

Jack-related links

+		 +Jack
+ + + + + + + + + + + + + + + + + + + + + + + + +
Description + Location +
scripToys - my collection of shell scripts, python hacks and C progs which make my (MP3-) life easier. + scripToys +
Python homepage + python +
LAME is not MP3 encoder - IMHO the best free MP3 encoder out there, much better than all other ISO-based encoders + lame +
cdparanoia homepage + cdparanoia +
tosha - a DAE tool which works on FreeBSD, Toshiba drives only + tosha +
cdrdao - DAO (Disc At Once) mode CD writing software + cdrdao +
alternate cursesmodule, use the patched version on the download page! + cursesmodule +
xtermset - control (running!) xterm properties via command line + xtermset +
JeFCo - the Jesterware FreeDB Collector, created to be the solution + of all your cddb problems. + Jesterware +
+ +

+Wanna go home? +

+ + +
+© Arne Zellentin, +zarne@users.sf.net +
+(changed: 10-Jan-00) + + + diff --git a/doc/main.gif b/doc/main.gif new file mode 100644 index 0000000..71c48ae Binary files /dev/null and b/doc/main.gif differ diff --git a/doc/mine.css b/doc/mine.css new file mode 100644 index 0000000..0e8edf6 --- /dev/null +++ b/doc/mine.css @@ -0,0 +1,96 @@ +BODY { + background: #072387; + background-repeat: repeat-y; + margin-left: 0; + margin-top: 0 +} +BODY, P, DL, UL { + color: #d0d840 + font-style: normal; + font-weight: normal; + font-variant: normal; + font-size: normal; + line-height: normal; + font-family: Helvetica, Arial, Verdana, sans-serif +} +IMG { + border: 0 +} +P.info { + color: #666666; + font-style: normal; + font-weight: normal; + font-variant: normal; + font-size: normal; + line-height: normal; + font-family: Helvetica, Arial, Verdana, sans-serif +} +#header { + font-style: normal; + font-weight: normal; + font-variant: normal; + font-size: small; + font-family: Helvetica, Arial, Verdana, sans-serif; + text-align: right +} +#footer { + font-style: normal; + font-weight: normal; + font-variant: normal; + font-size: small; + font-family: Helvetica, Arial, Verdana, sans-serif; + text-align: right +} +#menu { + color: #FFFFFF; + font-style: normal; + font-weight: bold; + font-variant: normal; + font-size: 12pt; + font-family: Helvetica, Arial, Verdana, sans-serif; + text-align: left +} +H1 { + color: #d0d840 + font-style: normal; + font-weight: bold; + font-variant: normal; + font-size: large; + font-family: Helvetica, Arial, Verdana, sans-serif +} +H2 { + color: #d0d840 + font-style: normal; + font-weight: normal; + font-variant: normal; + font-size: large; + font-family: Helvetica, Arial, Verdana, sans-serif +} +H3 { + color: #d0d840 + font-style: normal; + font-weight: bold; + font-variant: normal; + font-size: medium; + font-family: Helvetica, Arial, Verdana, sans-serif +} +H4 { + color: #d0d840 + font-style: normal; + font-weight: normal; + font-variant: normal; + font-size: medium; + font-family: Helvetica, Arial, Verdana, sans-serif +} +A:link { + #text-decoration: none; + color: #f0a840 +} +A:active { + #text-decoration: none; + color: #006699 +} +A:visited { + #text-decoration: none; + color: #a06820 +} diff --git a/doc/requirements.gif b/doc/requirements.gif new file mode 100644 index 0000000..8d53935 Binary files /dev/null and b/doc/requirements.gif differ diff --git a/doc/requirements.html b/doc/requirements.html new file mode 100644 index 0000000..8bb8cc5 --- /dev/null +++ b/doc/requirements.html @@ -0,0 +1,72 @@ + + +Jack's system requirements + + + +
+ + + + + + + +
+ + +
+

System requirements for Jack

+		 +Jack
+ +Jack has been developed using Linux, but I think it should work with other unices, too, as long as it resembles posix (has ptys, ...). If it doesn't work, tell me! +

+In order to run Jack, you must have the following installed: +

    +
  • python 1.5.2: with earlier versions freedb query and ripping-from-image +will not work. You also need the following modules (they are all part of the +python source distribution but some may not be installed by default, since +Version 2 Jack no longer needs threads; it's now a lot easier to get is to +work.): +
    • termios +
    • sndhdr +
    • urllib +
    • pty +
    • wav +
    + If it doesn't run, check these first! +
  • Ben Gertzfield's ID3 module WARNING: version 0.5 is buggy, use at least 0.6. No need to download it, I packaged it with jack. +
  • cdparanoia or tosha for audio extraction +
  • df (comes with any unix) +
+You will also have to install at least one of these MP3 encoders: + + +Optional: + +Wanna go home? + +
+ + +
+"All trademarks are owned by their owners" or whatever I have to state.
+© Arne Zellentin, +zarne@users.sf.net +
+(changed: 19-Aug-99) + + + + diff --git a/doc/screen.gif b/doc/screen.gif new file mode 100644 index 0000000..175ecd9 Binary files /dev/null and b/doc/screen.gif differ diff --git a/doc/screen.html b/doc/screen.html new file mode 100644 index 0000000..9eb3e92 --- /dev/null +++ b/doc/screen.html @@ -0,0 +1,62 @@ + + +Jack's status screen + + + +
+ + + + + + + +
+ + +
+

A screenshot of Jack working (with comments)

+		 +Jack
+ +

+
screenshot with comments
+

+ +(This shows the old 1.3.x version of Jack, 2.x.x look a bit different but nothing major) +

+Note that the xterm is automatically resized to fit all the tracks of the CD if you have xtermset installed (and enabled). +

+Jack is a console tool, somewhat in the great tradition of command-line oriented software. When using XTerm and xtermset the xterm's size is automagically changed to match the number of tracks. + +This is the meaning of the marked elements: +

    +
  • 1: the options line: list general options like MP3 bitrate, the WAV read-ahead,... +
  • 2: the DAE speed: how much faster than real-time the audio data has been extracted +
  • 3: the DAE status: actually, this is the output of cdparanoia, check cdparanoia -h for details on the used characters, e.g. a "+" means "Unreported loss of streaming/other error in read". +
  • 4: the encoder status: while encoding, the percentage along with the ETA is displayed, afterwards the speed-factor is given, how much faster (or, like in the exaple, slower) than real-time the encoding was +
  • 5: DAE in progress: the greater-sign indicates how far the extraction of this track has come, again, this is cdparanoia output. +
  • 6: the status line: how much disc-space is left, how many WAVs are waiting to be encoded, how many subprocesses are idle, and, finally, the error status. +
+ +

Update

+I made another screenshot of the more current version 2.2.0, using curses. +You will be able to understand it if you read above descriptions. + +

+
screenshot using curses
+

+ +Wanna go home? + +
+ + +
+© Arne Zellentin, +zarne@users.sf.net +
+(changed: 19-Aug-99) + + diff --git a/doc/todo.html b/doc/todo.html new file mode 100644 index 0000000..15b5218 --- /dev/null +++ b/doc/todo.html @@ -0,0 +1,43 @@ + + +Jack's TODO + + + +
+ + + + + + + +
+ + +
+

Future additions and other TODOs for Jack

+		 +Jack
+ +
    +
  • curses-"frontend" (MED) +
  • add more rippers and encoders (which?) (MED) +
  • GTK+ frontend (LOW) +
  • get alternate freedb sites, ... (LOW) +
  • create a man page (LOW) +
  • have Jack schedule encoders in reaction to system load (done but not perfect yet) +
  • re-check free space repeatedly, react to changes (done but still buggy) +
+Wanna go home? + +
+ + +
+© Arne Zellentin, +zarne@users.sf.net +
+(changed: 10-Jun-99) + + diff --git a/doc/usage.gif b/doc/usage.gif new file mode 100644 index 0000000..724bb12 Binary files /dev/null and b/doc/usage.gif differ diff --git a/doc/usage.html b/doc/usage.html new file mode 100644 index 0000000..f920023 --- /dev/null +++ b/doc/usage.html @@ -0,0 +1,329 @@ + + +Jack Usage + + + +
+ + + + + + + +
+ + +
+

Usage information for Jack

+		 +Jack
+ +Jack is mostly command line-driven, but there are some options which can only +be set by editing the preferences file, typically named $HOME/.jackrc. This +file is python code executed at startup so be careful. Invoke Jack with -h for +a short description of the command line options. +

+If you get bored reading documentation, check out the application examples! + +

+

Important things to configure in this file:

+ + + + + + + + + +
rename_fmt +with this variable you can determine how jack will rename your MP3s after a +freedb query. Use "%02i" for track number, "%a" for artist, "%l" for album name +and "%t" for track title. Example: "%02i.%a (%l) - %t" which would result in +"01.Artist (Album) - Track title.mp3" +
rename_fmt_va +same as above for "various artists" CDs. For normal CDs I use "%02i.%t.mp3" while I use ""%02i.%a - %t" for VA CDs. +
dir_template +if rename_dir is set, use this format for naming directories. Again, %a is substituted by the artist, %l is the album's name. I use "%a - %l" but "%a/%l" +is also common, every artist then has his own subdir. +
my_mailbe sure to set your e-mail address if you are planning to submit +freedb entries. Otherwise you won't get +feedback. +
xtermset_enable +I no longer use this since there is now a curses mode. Only set this if you have xtermset installed. +When enabled, Jack can - when running in an xterm - adjust the +size so all track information is visible. In addition, the xterm is deiconified +when all is done. +
+

+ +Everything else is controlled by the command line, try jack --help for a quick summary. You can still change the defaults by editing your .jackrc! + +

Command line options:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
-t, --tracks <tracks> +limit ripping and encoding to the specified +tracks, use comma to seperate track. Ranges are also possible; 5-9 is +equivalent to 5,6,7,8,9; 12- is like specifying track 12,...,last_track. The +default is to process the whole CD, I do not know why you would want an +incomplete rip, but be my guest. +
-b, --bitrate <bitrate> +bitrate of the resulting MP3 in kbit/s, default is 160. +
-v, --vbr +Generate variable bitrate MP3s, only on encoders which support this. Default is no. +
-e, --encoders <num_encoders> +encode how many MP3s in parallel. If +you have a SMP machine or simply want to stress your system, you can have Jack +encode several MP3s at once. Default is the number of CPUs I have, which is +one. +
--otf +On-the-fly operation. Only on some encoders/rippers. Do not create WAVs, pipe ripper output through the encoder. Default is no as it's a torture for the CDROM drive (IMHO). +
-E, --encoder-name <encoder_name> +choose which MP3 encoder to use, +valid choices are: blade, lame, l3enc, mp3enc. Note that you may have to install +the encoder. +
-n, --nice <nice_lvl> +nice-level with which the encoders are +started. Default is 12 which shouldn't hurt your system much. +
-l, --max-load <max_load> +only start new encoders if your system's load is below (max_load + num_encoders). If the load is too high, encoding operation is suspended until above criterium is satisfied. +
-a, --read-ahead <read_ahead> +read how many WAVs in advance. At most read_ahead + +num_encoders WAVs are ripped before a track has completely been encoded. Default is 99 which will +read the whole CD, provided there is enough disk space. +
-r, --reorder +optimize track-order for disk space. This can save you some +peak disk space during the encoding process; this may make it possible to do a +CD which would otherwise fail to be encoded. +
-s, --space <free_space> +forcably set usable diskspace, in bytes. This option lets you +limit the disk space Jack uses, maybe you need it for something else? Be +careful: if set too high, ripping and encoding will probably fail. The default +is to look how much is free and to use this value. +
-o, --overwrite +overwrite existing WAVs and MP3s, i.e. do not check if +already ripped WAVs or an already encoded MP3s seem to be ok. Use this if you +know something went wrong last time. This is off by default. +
-O, --only-dae +only produce WAVs, implies --keep-wavs. This is off by default. +
-k, --keep-wavs +do not delete WAVs after encoding them. Maybe you still +need them. +
-f, --from-tocfile <toc_file> +rip from CD image on hd. This option is a +somewhat special option. There are two reasons for it's existance: +
    +
  • When I copy a CD for my car stereo, most of the time I also want to +have it as MP3s. To copy a CD, I use the exellent tool cdrdao. This works best +when having the whole CD in a single WAV file, which I call the image. It also +needs a so-called toc-file containing the track, pregap, index, CD-TEXT, ... +information. If I use this image as the source, I do not have to rip the CD a +second time. My cdrom probably likes that. + +
  • same cdrdao has a great way of doing a bit-wise exact copy of the CD using +special Plextor-commands. This is superiour to cdparanoia as "bad" samples can +be detected and - hopefully - repaired. +
+The specified toc-file contains the name of the image file. +
-F, --from-image <image_file> +read audio data from image file. Like --from-tocfile, but +the image itself is specified instead of the tocfile. Use this if you do not +have a toc-file; the TOC is the read from the CD itself. +
-S, --swab +swap byteorder from image file. As cdrdao momentarily only +outputs "raw" .cdr files, you quite likely want to swap the byteorder. Try this +option if your WAVs and MP3s contain only noise (no, not the noise I call +music, the pseudo-random one). This is on by default as cdrdao currently +generates .cdr files that are "wrong". +
-c, --check-toc +compare toc-file and cd-toc, then exit. Jack caches the +TOC of a CD in a file ("jack.toc"). If you want to know if the inserted CD +matches the toc-file in the current directory, use this option. +
-g, --guess-toc <mp3_files> +make up a TOC from the MP3 file given in mp3_files. Format is: +
track_01.mp3 ... track_nn.mp3 ;
+Note that the trailing ";" is only necessary if you want to append more options +to your command line. This option makes me especially proud. You can use it to +do a freedb query based on MP3s alone - no need for the CD. Very useful if you +have no idea which CD the MP3s are from. The MP3s must be given in the same +order as they were on their CD. The generated TOC file is similar, but not +identical to the TOC of the CD - do not +submit these! +
--various +when parsing freedb data, jack assumes that if the disc's +artist is set to "Various Artists" the track titles have the format "[artist] - +[title]". If the disc title is set to something else and you still want above +behaviour, use --various. +
--no-various +use this if freedb data says it't "Various Artists" but you want the normal +renaming scheme, e.g. if Jack can't seperate artist and track title. +
--remove +have jack remove it's temp files. See below for details on these +files. Be careful - don't delete them too early! +
--upd-progress +have jack re-create it's temp files. Use this if you deleted them too early. +
-d, --dont-work +don't do DAE or encoding. This may be useful if you only want to +do a freedb query. +
-D, --create-dirs +tells Jack to create sub-directories in which Jack puts all the files +for the current CD. If no freedb data is available, i.e. when not using -Q, +these directorys will be named "jack-xxxxxxxx" where "xxxxxxxx" stands for the +CD's freedb-id. Otherwise dir_template (see above) will be used. +
--todo +print what would be done and exit. +
+

+

The following options are needed for freedb queries:

+ + + + + + + + + + + + + + + + + + + + + +
-q, --query +do freedb query when all is done. This is useful if Jack was prior run +without a freedb query. If all tracks are done you don't even have to have a CD +inserted as the TOC is cached by Jack. After having finished ripping and +encoding, Jack will rename the MP3s and tag them using Ben Gertzfield's ID3.py +module + +
-Q, --query-now +do freedb query when starting. Use this if you are +connected to the internet when starting jack. Know that the query may need +user-interaction. After having finished ripping and encoding, Jack will rename +the MP3s and tag them using Ben Gertzfield's ID3.py module +
-R, --rename-only +rename and tag files according to freedb file. On startup, Jack +creates a blank freedb entry file (except if --query-now is used, then the file +is queried from your freedb server). If you have changed it's contents (e.g. +because the CD was unknown to freedb) and want to rename and tag your MP3s +accordingly, use this option. +
-u, --undo-rename +undo file renaming and exit. If you don't like how jack renamed your files, use this option to restore the previous state. Note that ID3 tags are not restored. +
-m, --mail-submit +submit freedb entry via e-mail. HTTP submission is +preferred but while freedb only supports submission by e-mail you have to use +this. You will have to enter the category of the CD. +
-M, --mail-address <submit_addr> +when submitting a database entry via e-mail, use this +option to specify the address the entry is mailed to. Default is +freedb-submit@freedb.org. +
--my-email <your_mail> +use this to specify which e-mail address submission results are +mailed to. Please use your real e-mail address. +
--submit +submit freedb entry via HTTP. You will have to enter the category +of the CD. At the moment, this does not work with freedb. Or with a buggy +urllib. +
--server <freedb_server> +which freedb server to use. Don't forget to set your proxy. +Default server is freedb.freedb.org. +
--force +do not ask. Like when deleting incomplete (?!) files. +
+

+Jack creates a couple of files when running: + + + + +
  • jack.toc +
    		• The CD TOC (Table Of Contents) is cached here. Will be re-created +if deleted but be careful to insert the matching CD! +
  • jack.freedb +
    		• when you are not telling jack to do a freedb query, this file +is created as a freedb template file which you can fill out yourself. When +using --query or --query-now it is filled with the query-result. Existing files +are backed up as jack.freedb.bak. +
  • jack.progress +
    		• Status (main) screen output is cached here. When resuming +work, previously finished processes' output is still displayed. Jack also uses +this file to mark ripping/encoding steps as done, so if you delete this file, +everything is done again! +
    +Do not delete these files too early, this may case frustration! +

    +Wanna go home or do you wanna know how to install Jack? + +

    +"All trademarks are owned by their owners" or whatever I have to state. + +
    +© Arne Zellentin, +zarne@users.sf.net +
    +(changed: 19-Aug-99) + + + -- cgit v1.2.3