/ 
Music-Tag-MP3-0.32
/ Music::Tag::MP3

NAME

Music::Tag::MP3 - Plugin module for Music::Tag to get information from id3 tags

SYNOPSIS

	use Music::Tag

	my $info = Music::Tag->new($filename, { quiet => 1 }, "MP3");
	$info->get_info();
   
	print "Artist is ", $info->artist;

DESCRIPTION

Music::Tag::MP3 is used to read id3 tag information. It uses MP3::Tag to read id3v2 and id3 tags from mp3 files. As such, it's limitations are the same as MP3::Tag. It does not write id3v2.4 tags, causing it to have some trouble with unicode.

REQUIRED DATA VALUES

No values are required (except filename, which is usually provided on object creation).

SET DATA VALUES

mp3 file info added:
Currently this includes bitrate, duration, frequency, stereo, bytes, codec, frames, vbr,
id3v1 tag info added:

title, artist, album, track, comment, year and genre

id3v2 tag info added:

title, artist, album, track, totaltracks, year, genre, disc, totaldiscs, label, releasedate, lyrics (using USLT), url (using WCOM), encoder (using TFLT), and picture (using apic).

The following information is gathered from the ID3v2 tag using custom tags

TXXX[ASIN] asin TXXX[Sortname] sortname TXXX[MusicBrainz Artist Id] mb_artistid TXXX[MusicBrainz Album Id] mb_albumid TXXX[MusicBrainz Track Id] mb_trackid TXXX[MusicBrainz Album Type] album_type TXXX[MusicBrainz Artist Type] artist_type

Some data in the LAME header is obtained from MP3::Info (requires MP3::Info 1.2.3)

pregap postgap

METHODS

default_options

Returns the default options for the plugin.

set_tag

Save object back to ID3v2.3 and ID3v1 tag.

get_tag

Load information from ID3v2 and ID3v1 tags.

strip_tag

Remove the tag from the file.

close

Close the file and destroy the MP3::Tag object.

mp3

Returns the MP3::Tag object

calculate_gapless

Calculate gapless playback information. Requires patched version of MP3::Info and Math::Int64 to work.

OPTIONS

apic_cover

Set to false to disable writing picture to tag. True by default.

ignore_apic

Ignore embeded picture.

BUGS

ID3v2.4 is not read reliablly and can't be writen. Apic cover is unreliable in older versions of MP3::Tag.

CHANGES

Release Name: 0.32

  • Changed to TXXX:ALBUMARTISTSORT from TXXX:MusicBrainz Album Artist Sortname (will still read both). This is to partially address 54571.

Release Name: 0.31

  • Added support for EAN/UPC TXXX tag, and for reading and writing Music Magic fingerprints and data (puid).

Release Name: 0.30

  • Documentation Changes

Release Name: 0.29

  • Kwalitee fixes

  • Added Music::Info patch and explanation about gapless data

SEE ALSO INCLUDED

SEE ALSO

MP3::Tag, MP3::Info, Music::Tag

AUTHOR

Edward Allen III <ealleniii _at_ cpan _dot_ org>

COPYRIGHT

Copyright (c) 2007,2008 Edward Allen III. Some rights reserved.

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either:

a) the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or

b) the "Artistic License" which comes with Perl.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See either the GNU General Public License or the Artistic License for more details.

You should have received a copy of the Artistic License with this Kit, in the file named "Artistic". If not, I'll be glad to provide one.

You should also have received a copy of the GNU General Public License along with this program in the file named "Copying". If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA or visit their web page on the Internet at http://www.gnu.org/copyleft/gpl.html.