What is dagger?
---------------

dagger is a small command-line utility written in python which tags and
renames audio-files. Currently supported formats are MP3 and OGG Vorbis.

You can get the newest version at http://freewarepoint.de/dagger/

System requirements
-------------------

Program        Version        URL

Python         >= 2.3         http://www.python.org
id3v2          == 0.1.11      http://id3v2.sourceforge.net/
vorbis-tools   >= 1.0         http://www.xiph.org/downloads/


Configuration file
------------------

Instead of typing the options every time you run dagger it is possible
to save these in a file called ".daggerrc" which must be placed in your
home-directory.

All options have to be placed in profiles which are marked with
"[profilename]", one per line. The names of the options are equal to the
long format you give to dagger without using the configuration file.
Options without a value like "create-dirs" may be set to 0 (disabled) or
1 (enabled).

The profile "default" will be used every time you run dagger. If you
specify another one with "--profile", those settings will override the
default.

A short example:

[default]
normalize=1
[ripped]
normalize=0
create-dirs=1
rename=%n - %t

With these options dagger will always normalize your filenames, but not
if your are using the profile "ripped".


Normalizing
-----------

The option "--normalize" tries to apply the "Editing Style" from
musicbrainz.org for english files as much as possible. All words will be
printed uppercase except for short words, articles and conjunctions.

Please note: If you use "--normalize" without renaming the files,
only the tags are changed.

Frequently Asked Questions (FAQ)
--------------------------------

- What does happen when I use "--rename" and "--tag" together?

  The order in which dagger processes is the following (depending on options):

  1. Read current tag from file
  2. If "--set-auto-tracknum" is used, set the tracknumber
  3. Update the tag using the filename
  4. Perform regexp replace
  5. If any "--set-"-options are used, set those tags
  6. Rename the file using the tag

  So the answer to your question is: At first, dagger will update the
  tag of the file. After that, it renames the file using the tag.


Thanks to
---------

- Benjamin Hanzelmann, for writing the regexp parser,
  manpages and testing dagger
- Christoph Leuzinger, for providing the iTunes-patch
  and testing