MKAT
------

MKAT is a set of command line tools to burn and catalog data, audio CDs
or arbitrary directories and then search the catalog database.

It uses mkisofs and cdrecord to create iso image and burn CDs, -r option allows 
to pass through options to cdrecord. Cdrecord and mkisofs options can be
configured in /etc/mkatrc and ~/.mkatrc. Catalog tools are mkat and mkata,
burn tools are burn and burna, with trailing `a' standing for `audio'.

It has been made because I was tired of specifying parameters to mkisofs and
cdrecord, and I also wanted a database of my CD collection that could be
simple, easy to read and searchable with grep.

NOTE: I use autofs to mount Cd-ROM for checking and cataloguing, actually, I
just don't mount it explicitly and eject after sleeping $AUTOFS_DELAY seconds.
Set unmount timeout for autofs to $AUTOFS_DELAY seconds or CD won't eject after 
everything's done. Also, it's useful to look at created iso image before 
burning, I have the following lines in my /etc/auto.misc:
iso             -fstype=iso9660,ro,sync,nodev,nosuid,loop :/home/ledestin/cdimage.iso
cd              -fstype=iso9660,ro,sync,nodev,nosuid,speed=32   :/dev/sr0
I also have a symlink
lrwxrwxrwx    1 root     root           17 2004-04-21 13:13 /misc -> /var/autofs/misc/
so I can just say `ls /misc/iso' and see the contents of the iso image.

INSTALLATION

`make install' if you're a not Debian user, apt-get otherwise.
`make uninstall' is also available.

MKAT depends on cdrecord, mkisofs, sed, awk, dotlockfile, cdparanoia,
cd-discid present, the last two only required for work with audio CDs.

CONFIGURATION

/etc/mkatrc and ~/.mkatrc are sourced by the tools in that order,
.mkatrc settings override global settings from /etc/mkatrc.

On a Debian system I use debconf and a config will be created automatically
after you answer questions. But if you install from a tarball you need to
edit config file before running anything. I provide a sample config file 
in examples/mkatrc, which is copied to /etc/mkatrc on install.

See manual page mkatrc(5) for more info.

DESCRIPTION

mkat creates a file in $LISTDIR (see mkatrc(5)) named after CD label with
first line being a label, consecutive lines listing CD contents, e.g.
FMP2 1-4
[A-F_&_AF]_Fullmetal_Panic_Fumoffu_-_04.avi:175M:b43e0fd3bd7f3afc97b47a75810276d3
[A-F_&_AF]_Fullmetal_Panic_Fumoffu_-_03.avi:175M:7cfd53c75e2753aafea0e6fddcfb4e07
[A-F_&_AF]_Fullmetal_Panic_Fumoffu_-_02.avi:175M:d6f3b47f254df00d4419fddf59919bb1
[A-F_&_AF]_Fullmetal_Panic_Fumoffu_-_01.avi:176M:635f23f89dd69fff11162a89655f5ca1

That is file description consists of the file name, size, md5 sum.

TAGS

If you wish to categorize your collection, use tags like 'movie', 'anime',
'comedy', 'adventure', etc. (e.g. 
http://animenfo.com/animetitle,114,tzoabg,cowboy_bebop.html).

You can specify tags when burning:
burn '-m-t anime,comedy,adventure' 'Cowboy Bebop' .

or when you wish to catalog already burned:
mkat -t anime,comedy,adventure

Or, if you have a .list file already, edit it, adding
"tags: anime comedy adventure" as the *SECOND* line.
$vi ~/.mkat/Cowboy\ Bebop.list

"mkat -S anime" will print all list files with "anime" tag,
"mkat -S movie,romance" will print files containing both "movie" and
"romance" tags.

List existing tags with "mkat -a".

GETTING A NEW VERSION

This project is hosted at https://savannah.nongnu.org/projects/mkat/

FEEDBACK

I'll be glad to hear any feedback from you. How do you find the package, how
did you use, what was your experience, etc. Write me at ledestin@amur.ru

LICENSE

Mkat is released under GPL, see LICENSE for more info.

--
/Dmitry Maksyoma <ledestin@amur.ru>, Fri, 28 Feb 2005 23:03:29 +0900

Copyright 2004, 2005 Dmitry Maksyoma
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
