Edward J. Allen III > Music-Tag-MP3-0.29 > Music::Tag::MP3

Download:
Music-Tag-MP3-0.29.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  1
View Bugs
Report a bug
Module Version: 0.29   Source  

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 VALUES ^

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

SET 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

OPTIONS ^

apic_cover

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

ignore_apic

Ignore embeded picture.

calculate_gapless

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

BUGS ^

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

SEE ALSO INCLUDED ^

Music::Tag, Music::Tag::Amazon, Music::Tag::File, Music::Tag::FLAC, Music::Tag::Lyrics, Music::Tag::M4A, Music::Tag::MusicBrainz, Music::Tag::OGG, Music::Tag::Option,

SEE ALSO ^

MP3::Tag, MP3::Info

AUTHOR ^

Edward Allen III <ealleniii _at_ cpan _dot_ org>

LICENSE ^

This program is free software; you can redistribute it and/or modify it under the terms of the Artistic License, distributed with Perl.

COPYRIGHT ^

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