.TH "tagmp3" "1" "27. Juli 2004" "tagmp3 v1.3" "User manual"
.SH "NAME "
tagmp3 \- verändert ID3v1 Tags
.SH "ÜBERSICHT"
.PP 
\fBtagmp3\fP
[
\fB\-n\fP
]
\fImodus\fP
[
\fIformat\fP
] [
\fIdatei\fP
] ...
.br 
\fBtagmp3\fP \fB\-h\fP
.br 
\fBtagmp3\fP \fB\-v\fP
.SH "BESCHREIBUNG"
.PP 
\fBtagmp3\fP kann ID3v1\-Tags von mp3\-Dateien setzen oder entfernen.
Zusätzlich können im Modus \fImove\fP mp3\-Dateien anhand ihrer ID3v1\-Tags
verschoben werden. Ein ID3v1\-Tag ist ein Teil von zusätzlichen Informationen,
wie Künstlername, Album und Genre. ID3v1\-Tags werden von den meisten mp3\-Spielern
angezeigt.
.SH "MODUS"
.IP \fIshow\fP
anzeigen der ID3v1\-Tags der \fIdatei\fP.
.IP \fIset\fP 
setzen der ID3v1\-Tags der \fIdatei\fP anhand von \fIformat\fP.
.IP \fImove\fP 
verschieben der \fIdatei\fP anhand von \fIformat\fP.
.IP \fIdel\fP 
entfernt den ID3v1\-Tag der \fIdatei\fP, wenn vorhanden.
.IP \fIlist\fP
zeigt die Kennziffern der Musik\-Genres und deren Bedeutung an.


.SH "OPTIONEN"
.IP \fB\-n\fP
Nur anzeigen was zu tun ist, keine Dateien ändern.
.IP \fB\-h\fP
Zeigt einen (nicht sehr) kurzen Hilfe\-Text.
.IP \fB\-v\fP
Zeigt Version und beendet sich.
.SH "FORMAT STRING"
Der Format\-STRING ist eine Zeichenkette, die aus keiner oder mehr Anweisungen
besteht. Enthalten sind normale Zeichen (kein %), die nicht interpretiert
werden und Umwandlungsanweisungen, die mit einem entsprechenden Feld im ID3\-Tag
verbunden sind. Jede Anweisung beginnt mit dem Zeichen '%'. Die Folge '%%' 
beschreibt das Zeichen '%' selbst. Die Anweisungen und ihre zugehörigen
ID3v1\-Tag\-Felder sind:
.IP %A
Künstlername
.IP %a 
Albumname
.IP %t
Liedtitel
.IP %T
Titelnummer
.IP %y 
Jahr
.IP %g 
Genre
.IP %c
Kommentar
.PP 
Im Modus \fIset\fP ist der Format\-STRING eine Liste von ID3v1\-Tag\-Feldern, 
gefolgt von ':' und dem Wert für dieses Feld oder nur '?', um vom Benutzer
den Wert abzufragen. (Siehe BEISPIELE)
.PP 
Im Modus \fImove\fP können die Anweisungen im Zielpfad eingebaut werden und
sie werden durch den Inhalt des zugehörigen ID3v1\-Tag\-Feldes ersetzt.
(Siehe BEISPIELE)
.SH "BEISPIELE"
.PP 
\fBtagmp3 set "%A:Pink Floyd %a:The Wall %t? %T?" *.mp3\fP
.IP 
Bei jeder mp3\-Datei im aktuellen Verzeichnis wird der Künstlername
auf 'Pink Floyd' und der Albumname auf 'The Wall' gesetzt.
Bei jeder Datei wird nach dem Titel und der Titelnummer gefragt. Die anderen
Felder bleiben unberührt. Beachten Sie, dass das Genre\-Feld eine Zahl verlangt.
Bekannte Genres können im Modus \fIlist\fP angesehen werden.
.PP 
\fBtagmp3 move "/home/foo/mp3/%A/%a/%T\-%t.mp3" *.mp3\fP
.IP 
Jede mp3\-Datei im aktuellen Verzeichnis wird verschoben nach
/home/foo/mp3/<Künstlername>/<Albumname>/<Titelnum>\-<Titel>.mp3 
.PP 
\fBtagmp3 move "%A\-%t.mp3" *.mp3\fP
.IP 
Wenn Sie eine flache Hierarchie haben wollen.
.SH "NOTIZEN"
.PP 
Im Modus \fImove\fP werden niemals Dateien überschrieben.
.PP 
Im Modus \fImove\fP werden evtl. neue Verzeichnisse angelegt, die im 
Format\-STRING angegeben sind. Jedes neue Verzeichnis muss von Benutzer
bestätigt werden.
.PP 
Wenn eine Datei nicht verschoben werden kann (falscher Dateityp, kein ID3v1\-Tag
vorhanden oder das Feld ist leer, usw.), dann bleibt sie unberührt.
.PP 
Falsche mp3\-Dateien (z.\ B. wav\-Dateien mit der Endung .mp3) werden im Modus
\fImove\fP in das Verzeichnis "fake\-mp3/" verschoben. Im Modus \fIset\fP
werden keine Felder gesetzt, weil das Störgeräusche am Ende des Titels 
verursachen würde.
.SH "FEHLER"
.PP 
Eine Menge :)
.PP 
Im Modus \fImove\fP müssen Quell\- und Zielverzeichnis im gleichen Dateisystem
bzw. Partition liegen.
.SH "AUTOR"
.PP 
Laurent Alacoque <laureck@users.sourceforge.net> CopyLeft 2001
.PP 
Erik Schanze <schanzi_@gmx.de> hat die Manpage angepasst und
ins Deutsche übersetzt.
.PP 
Neue Releases sind zu finden und Fehler, Patches, Infos zu senden an:
.br 
http://mpgtx.sourceforge.net/