/ 
Music-Tag-M4A-0.3
River stage zero No dependents
/ Music::Tag::M4A

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 contonainers. It uses Audio::M4P::QuickTime and MP4::Info.

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

REQUIRED VALUES

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

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

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 writen to disc. Not recommended.

BUGS

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

SEE ALSO INCLUDED

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

SEE ALSO

Audio::M4P::QuickTime, MP4::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.