NAME

Music::Tag::M4A - Plugin module for Music::Tag to get information from Apple QuickTime headers.

SYNOPSIS

use Music::Tag

my $filename = "/var/lib/music/artist/album/track.m4a";

my $info = Music::Tag->new($filename, { quiet => 1 }, "M4A");

$info->get_info();
   
print "Artist is ", $info->artist;

DESCRIPTION

Music::Tag::M4A is used to read header information from QuickTime MP4 containers. It uses Audio::M4P::QuickTime and MP4::Info.

It is not currently able to write M4A tags (safely). Audio::M4P::QuickTime can write these tags, but iTunes has trouble reading them after they have been written. Setting the option "write_m4a" will enable some tags to be written, but iTunes will have problems!

REQUIRED DATA VALUES

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

SET DATA VALUES

artist, album

disc, totaldiscs, tempo, encoder, title, composer

copyright, track, totaltracks, comment, lyrics

bitrate, duration, picture

METHODS

default_options()

Returns the default options for the plugin.

set_tag()

Save object back to MPEG4 container. THIS IS DANGEROUS. Requires write_m4a be set to true.

get_tag()

Load information from MPEG4 container.

set_values()

A list of values that can be set by this module.

saved_values()

A list of values that can be saved by this module.

get_tag_qt_info()

Load information using Audio::M4P::QuickTime

get_tag_mp4_info()

Load information using MP4::Info

close()

Close the file and destroy the Audio::M4P::QuickTime object. As this can be large, do this soon after running get_tag if you do not intend to write back to the file ever.

qt()

Returns the Audio::M4P::QuickTime object

OPTIONS

write_m4a

Set to true to allow some tags to be written to disc. Not recommended.

BUGS

M4A Tags are error-prone. Writing tags is not reliable.

Please use github for bug tracking: http://github.com/riemann42/Music-Tag-M4A/issues.

SEE ALSO

Audio::M4P::QuickTime, MP4::Info, Music::Tag

SOURCE

Source is available at github: http://github.com/riemann42/Music-Tag-M4A.

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 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.

COPYRIGHT

Copyright © 2007,2010 Edward Allen III. Some rights reserved.

cpanm Music::Tag::M4A

perl -MCPAN -e shell
install Music::Tag::M4A