Scroll to navigation

ID3TOOL(1) General Commands Manual ID3TOOL(1)


id3tool - a command line editor for id3 tags.


id3tool [options] files ...


This manual page is for the id3tool command.

id3tool is a program that can be used to view and edit id3 tags from the command line.

When invoked from the command line with filenames and no options, it will display the used fields of the id3 tags.

When invoked from the command line with filenames and "set" options, it will change the id3 tag fields specified to the specified values on all the files.

Due to limitations in the ID3v1 specification, most fields are limited to 30 characters.

The note field is limited to 28 characters if a track number is in use.

You can force a tag to be v1.1 by using a specifying a non-zero track number, or force a tag to be v1.0 by specifying a track number of zero (0).


The programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A complete list of options are included below. For a complete description, use the help option.

Sets the title to WORD
Sets the album to WORD
Sets the artist to WORD
Sets the year to YEAR [4 digits]
Sets the note to WORD
Sets the genre code to INT (the codes can be acquired from the genre list.)
Sets the genre to WORD (given that WORD is from the genre list.)
Sets the track to INT
Show summary of options.
Show version of program.
Shows the genre list.


id3tool and this manual page were written by Chris Collins <>