.TH ID3 1
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH NAME
id3 \- an ID3 tag editor.
.SH SYNOPSIS
.B id3
.I [\-taAycg] file1 [file2 [file3...]]
.br
.B id3
.I -l file1 [file2 [file3...]]
.br
.B id3
.I -d file1 [file2 [file3...]]
.br
.B id3
.I -L
.SH "DESCRIPTION"
id3 is an ID3 tag editor. ID3 tags are traditionally put at the end of
compressed streamed audio files to denote information about the audio
contents. Up to thirty characters of Title, Artist, Album, and Comment
information can be stored, as well as a four-digit year and an enumerated
genre.
.SH OPTIONS
.TP
.B \-t
Modify the Title tag.
.TP
.B \-a
Modify the Artist tag.
.TP
.B \-A
Modify the Album tag.
.TP
.B \-y
Modify the Year tag.
.TP
.B \-c
Modify the Comment tag.
.TP
.B \-g
Modify the Genre tag.
.TP
.B \-l
List/view the ID3 tag.
.TP
.B \-L
List all genre tags.
.TP
.B \-R
Use rfc822-style output for tag printout.
.TP
.B \-d
Delete the ID3 tag.
.SH BUGS
The ID3 format has some shortcomings. There is a 1 in 16777216 chance of
your mp3 having a certain bit-pattern, causing id3 to write over the last
128 bytes of your mp3 upon tag creation. Also because the ID3 format is
space-padded, not null-padded, trailing spaces will be ignored by most
players. Any bugs found in
.B id3
should be forwarded to the author, Robert Woodcock <rcw@debian.org>.
