# Application examples |

- 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 eMail as freedb does not support http submissions as of now. Sendmail must be working on your machine!):

      $ jack -m

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?

(changed: Wednesday, 06-Feb-2002 23:57:24 CET)