Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

id3tool(1) [debian man page]

ID3TOOL(1)						      General Commands Manual							ID3TOOL(1)

NAME
id3tool - a command line editor for id3 tags. SYNOPSIS
id3tool [options] files ... DESCRIPTION
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). OPTIONS
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. -t, --set-title=WORD Sets the title to WORD -a, --set-album=WORD Sets the album to WORD -r, --set-artist=WORD Sets the artist to WORD -y, --set-year=YEAR Sets the year to YEAR [4 digits] -n, --set-note=WORD Sets the note to WORD -g, --set-genre=INT Sets the genre code to INT (the codes can be acquired from the genre list.) -G, --set-genre-word=WORD Sets the genre to WORD (given that WORD is from the genre list.) -c, --set-track=INT Sets the track to INT -h, --help Show summary of options. -v, --version Show version of program. -l, --genre-list Shows the genre list. AUTHOR
id3tool and this manual page were written by Chris Collins <xfire@xware.cx> ID3TOOL(1)

Check Out this Related Man Page

ID3_GET_TAG(3)								 1							    ID3_GET_TAG(3)

id3_get_tag - Get all information stored in an ID3 tag

SYNOPSIS
array id3_get_tag (string $filename, [int $version = ID3_BEST]) DESCRIPTION
id3_get_tag(3) is used to get all information stored in the id3 tag of the specified file. PARAMETERS
o $filename - The path to the MP3 file Instead of a filename you may also pass a valid stream resource o $version - Allows you to specify the version of the tag as MP3 files may contain both, version 1.x and version 2.x tags Since version 0.2 id3_get_tag(3) also supports ID3 tags of version 2.2, 2.3 and 2.4. To extract information from these tags, pass one of the con- stants ID3_V2_2, ID3_V2_3 or ID3_V2_4 as the second parameter. ID3 v2.x tags can contain a lot more information about the MP3 file than ID3 v1.x tags. RETURN VALUES
Returns an associative array with various keys like: title, artist, .. The key genre will contain an integer between 0 and 147. You may use id3_get_genre_name(3) to convert it to a human readable string. EXAMPLES
Example #1 id3_get_tag(3) example <?php $tag = id3_get_tag( "path/to/example.mp3" ); print_r($tag); ?> The above example will output something similar to: Array ( [title] => DN-38416 [artist] => Re:Legion [album] => Reflections [year] => 2004 [genre] => 19 ) Example #2 id3_get_tag(3) example <?php $tag = id3_get_tag( "path/to/example2.mp3", ID3_V2_3 ); print_r($tag); ?> The above example will output something similar to: Array ( [copyright] => Dirty Mac [originalArtist] => Dirty Mac [composer] => Marcus Gotze [artist] => Dirty Mac [title] => Little Big Man [album] => Demo-Tape [track] => 5/12 [genre] => (17)Rock [year] => 2001 ) SEE ALSO
id3_set_tag(3), id3_remove_tag(3), id3_get_version(3). PHP Documentation Group ID3_GET_TAG(3)
Man Page