Fetching latest commit…
Cannot retrieve the latest commit at this time
|Failed to load latest commit information.|
|examples||# Use single quotes in the example config due to recent changes to code.|
MKAT ---- MKAT is a set of command line tools to burn and catalog data CD/DVD/BD, audio CD or arbitrary directories and then search the catalog database. Catalog tools are mkat and mkata, burn tools are burn and burna, with trailing `a' standing for `audio'. burn(1) uses genisoimage to create iso image and wodim/growisofs to burn CD/DVD/BD. It has options that allow to pass arguments to image making, burning and cataloging programs. In principle, it's possible to redefine CD_OPTS/DVD_OPTS and CD_BURN_CMD/DVD_BURN_CMD in one of the config files to use other programs. See burn(1) code for *_OPTS definition. These commands were made because I was tired of specifying parameters to genisoimage and wodim, and I also wanted a database of my disk collection that could be simple, easy to read and searchable with grep. NOTE: I use autofs to mount a disc for checking and cataloging. Actually, I just don't mount it explicitly and eject after sleeping $AUTOFS_DELAY seconds. Set unmount timeout for autofs to an appropriate number of seconds or the disk won't eject after everything's done (because it still will be mounted by autofs). Also, as 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 or the disk. INSTALLATION Debian: dpkg -i mkat_0.5-1_all.deb apt-get -f install Non-Debian (tarball): `make install' and `make uninstall' MKAT depends on wodim, dvd+rw-tools, genisoimage, sed, awk, dotlockfile, realpath, cdparanoia, cd-discid present, the last two only required for working with audio CDs. burn(1) depends on wodim, dvd+rw-tools, dotlockfile exclusively, so if you don't intend to use it, no need for them. The same thing goes for burna(1) and cdparanoia. CONFIGURATION /etc/mkatrc and ~/.mkatrc are sourced by the tools in that order, ~/.mkatrc settings override global settings from /etc/mkatrc. Both tarball and deb installers recognize ###CUSTOM SECTION string as the end of the default section. New options supplied with default config are written into default options and locally modified part is written after the defaults this way the defaults can be easily overrided. 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 on configuration. DESCRIPTION mkat creates a file in $LISTDIR (see mkatrc(5)) named after disk label with first line being the label and the consecutive lines listing disc 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, a 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 the `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's deliverables are hosted at http://ledestin.github.com/mkat/ Git repository: https://github.com/ledestin/mkat.git FEEDBACK You are welcome to conctact me at firstname.lastname@example.org. LICENSE MKAT is released under GPL, see LICENSE for more info. -- /Dmitry Maksyoma <email@example.com>, Sat, 23 Mar 2013 09:28:58 +1300 Copyright 2004, 2005, 2013 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.