Edward J. Allen III > Music-Tag-M4A-0.3 > Music::Tag::M4A

Download:
Music-Tag-M4A-0.3.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
Report a bug
Module Version: 0.3   Source  

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.