.TH MP3TAG 1 "February 19, 2004"
.SH NAME
mp3tag \- view and manipulate ID3v1 tags.
.SH SYNOPSIS
.B mp3tag
[
.BI \-s \ song
] [
.BI \-a \ artist
] [
.BI \-l \ album
] [
.BI \-y \ year
] [
.BI \-e \ comment
] [
.BI \-k \ track
] [
.BI \-g \ genre
] [
.B \-r
]
.I file
[ \fIfile\fR ... ]
.SH "DESCRIPTION"
This manual page briefly documents the \fBmp3tag\fR command. This manual page 
was written for the Debian GNU/Linux distribution because the original program 
does not have one. 

\fBmp3tag\fR is a program that allows you to both view and manipulate ID3v1 
metadata tags. Running the command with just a filename will display the 
file's current tag. Setting some options will cause the tag to be updated and 
displayed.
.SH OPTIONS
.TP
.BI \-a \ artist
Set the artist name to \fIartist\fR. Strings over thirty characters are 
truncated.
.TP
.BI \-e \ comment
Set the comment to \fIcomment\fR. Strings over thirty characters are truncated.
.TP
.BI \-g \ genre
Set the genre to \fIgenre\fR. This is a single integer with a value of 0 to 254 
corresponding to the appropriate Winamp compatible genre (use '\fB\-g\fR list' 
to list all supported genres).
.TP
.BI \-k \ track
Set the track number to \fItrack\fR. This is a single integer with a value of 0 
to 255. Specifying this field truncates the comment field to twenty-eight 
characters, as per the ID3v1.1 standard.
.TP
.BI \-l  \ album
Set the album name to \fIalbum\fR. Strings over thirty characters are truncated.
.TP
.B \-r
Merge new tag with any preexisting tag in the file.
.TP
.BI \-s \ song
Set the song name to \fIsong\fR. Strings over thirty characters are truncated.
.TP
.BI \-y \ year
Set the year to \fIyear\fR. Strings over four characters are truncated.
.SH EXAMPLES
.TP
Display foo.mp3's current ID3v1 info:

\fBmp3tag\fR foo.mp3
.TP
Set foo.mp3's artist to 'Bar', and album to 'Baz':

\fBmp3tag\fR -a Bar -l Baz foo.mp3
.TP
Set foo.mp3's year to 2001, merging it with any tag already present:

\fBmp3tag\fR -y 2001 -r foo.mp3
.SH AUTHOR
\fBmp3tag\fR was written by Bram Avontuur <bram@avontuur.org>.

This manual page was written by Brian Boucheron <brian@boucheron.org>, for the 
Debian GNU/Linux distribution (but may be used by others).
.SH "SEE ALSO"
More info on ID3v1 can be found at <http://www.id3.org/id3v1.html>.