ID3_GET_TAG(3) 1 ID3_GET_TAG(3)id3_get_tag - Get all information stored in an ID3 tagSYNOPSIS
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)
Check Out this Related Man Page
TAGGREPPER(1) User Commands TAGGREPPER(1)NAME
taggrepper - search and match tags of media file for regular expressions
SYNOPSIS
taggrepper [--tag-label regexp]... [--display-taglabel]... [FILE/DIRECTORY]...
DESCRIPTION
Perform a regular expression search on the tags of specified media files.
Mandatory arguments to long options are mandatory for short options too. All regular expressions are Perl Compatible Regular expressions
supported by the PCRE libraries. Note that all matches are ANDed, meaning that for a successful match, matches against all tags must occur.
Support exists for MP3 files, and, if compiled in, for Ogg Vorbis and FLAC files as well.
-t, --title=REGEXP
Match the title tag against REGEXP
-a, --artist=REGEXP
Match the artist tag against REGEXP
-l, --album=REGEXP
Match the album, tag against REGEXP
-y, --year=REGEXP
Match the year tag against REGEXP
-g, --genre=REGEXP
Match the genre tag against REGEXP
-c, --comment=REGEXP
Match the comment tag against REGEXP
--track=REGEXP
Match the track tag against REGEXP
-c, --composer=REGEXP
Match the composer tag against REGEXP
-o, --orig-artist=REGEXP
Match the original artist tag against REGEXP
-c, --copyright=REGEXP
Match the copyright tag against REGEXP
-u, --url=REGEXP
Match the URL tag against REGEXP
-e, --encoded-by=REGEXP
Match the encoded-by tag against REGEXP
--any-tag=REGEXP
Match the encoded-by tag against REGEXP. Using this option makes every one of the above options to be ignored
--display-title
display title tag of matching files
--display-artist
display artist tag of matching files
--display-album
display album tag of matching files
--display-year
display year tag of matching files
--display-genre
display genre tag of matching files
--display-comment
display comment tag of matching files
--display-track
display track tag of matching files
--display-composer
display composer tag of matching files
--display-orig-artist
display orig-artist tag of matching files
--display-copyright
display copyright tag of matching files
--display-url
display url tag of matching files
--display-encoded-by
display encoded-by tag of matching files
-0, --print0,
Use null character as delimiter. This option can be used with -0 option of xargs.
-r, --recursive
Search directories recursively
-v, --version
Display version and exit
-h, --help
Display this help message
All regular expressions are PCRE regular expressions. Refer to the PCRE documentation for details. Report comments and bugs to
a.kumar@alumni.iitm.ac.in
COPYING
Copyright (C) Kumar Appaiah
License: BSD License (see COPYING file in the distribution tarball for details)
This program is free software; you can distribute it under the terms of the BSD License. See the file COPYING in the tarball, or
/usr/share/common-licenses/BSD on Debian-based systems.
SEE ALSO pcre(3)taggrepper 0.01 July 2009 TAGGREPPER(1)