Music-Tag-MP3

 view release on metacpan or  search on metacpan

META.yml  view on Meta::CPAN

    ExtUtils::MakeMaker:  0
build_requires:
    ExtUtils::MakeMaker:  0
requires:
    Data::Dumper:  2
    Encode:        2.12
    File::Copy:    0
    File::Spec:    3.24
    IO::File:      1.13
    MP3::Info:     1.23
    MP3::Tag:      1.13
    Music::Tag:    0.4101
    Test::More:    0
no_index:
    directory:
        - t
        - inc
generated_by:       ExtUtils::MakeMaker version 6.56
meta-spec:
    url:      http://module-build.sourceforge.net/META-spec-v1.4.html
    version:  1.4

Makefile.PL  view on Meta::CPAN

               VERSION_FROM => 'lib/Music/Tag/MP3.pm',
               ABSTRACT_FROM => 'lib/Music/Tag/MP3.pm',
               AUTHOR       => 'Edward Allen (ealleniii _at_ cpan _dot_ org)',
			   LICENSE		=> 'perl',
               PREREQ_PM => { 'Music::Tag'			    => 0.4101, 
                              'Data::Dumper'            => 2.0,
                              'Encode'                  => 2.12,
                              'File::Spec'              => 3.24,
                              'IO::File'                => 1.13,
                              'MP3::Info'               => 1.23,
                              'MP3::Tag'                => 1.13,
							  'Test::More'				=> 0,
							  'File::Copy'				=> 0,
                            },
             );

README  view on Meta::CPAN

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

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.

INSTALLATION
    To install this module type the following:

       perl Makefile.PL
       make
       make test
       make install

DEPENDENCIES
    This module requires these other modules and libraries:

       Muisc::Tag
       MP3::Tag
       MP3::Info

    Do not install an older version of MP3::Tag.

NOTE ON ID3v2.4 TAGS
    There seems to be a bug with MP3::Tag::ID3v2 0.9709. To use ID3v2.4
    tags, download MP3::Tag from CPAN and apply the following patch:

       patches/MP3-Tag-0.9709.ID3v2.4.patch

    To do this change directory to the MP3::Tag download directory and type

       patch -p1 < ../Music-Tag-MP3/patches/MP3-Tag-0.9709.ID3v2.4.patch

    Then install as normal

       perl Makefile.PL
       make && make test
       make install

NOTE ON GAPLESS INFO

lib/Music/Tag/MP3.pm  view on Meta::CPAN

package Music::Tag::MP3;
use strict; use warnings; use utf8;
our $VERSION = '0.4101';

# Copyright © 2007,2010 Edward Allen III. Some rights reserved.
#
# You may distribute under the terms of either the GNU General Public
# License or the Artistic License, as specified in the README file.

use MP3::Tag;
use MP3::Info;
use base qw(Music::Tag::Generic);

sub default_options {
    { apic_cover => 1, };
}

sub _decode_uni {
    my $in = shift;
    my $c = unpack( "U", substr( $in, 0, 1 ) );

lib/Music/Tag/MP3.pm  view on Meta::CPAN

        #$in =~ s/^[^A-Za-z0-9]*//;
        #$in =~ s/ \/ //g;
    }
    return $in;
}

sub mp3 {
    my $self = shift;
    unless ( ( exists $self->{'_mp3'} ) && ( ref $self->{'_mp3'} ) ) {
        if ( $self->info->get_data('filename') ) {
            $self->{'_mp3'} = MP3::Tag->new( $self->info->get_data('filename') );
        }
        else {
            return undef;
        }
    }
    return $self->{'_mp3'};
}

sub _auto_methods_map {
    return {

lib/Music/Tag/MP3.pm  view on Meta::CPAN

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

=for readme continue

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

=begin readme

=head1 INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

=head1 DEPENDENCIES

This module requires these other modules and libraries:

   Muisc::Tag
   MP3::Tag
   MP3::Info

Do not install an older version of MP3::Tag. 

=head1 NOTE ON ID3v2.4 TAGS

There seems to be a bug with MP3::Tag::ID3v2 0.9709. To use ID3v2.4 tags,
download MP3::Tag from CPAN and apply the following patch:

   patches/MP3-Tag-0.9709.ID3v2.4.patch

To do this change directory to the MP3::Tag download directory and type

   patch -p1 < ../Music-Tag-MP3/patches/MP3-Tag-0.9709.ID3v2.4.patch

Then install as normal

   perl Makefile.PL
   make && make test
   make install

=head1 NOTE ON GAPLESS INFO

lib/Music/Tag/MP3.pm  view on Meta::CPAN

=item B<saved_values()>

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

=item B<strip_tag()>

Remove the tag from the file.

=item B<close()>

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

=item B<mp3()>

Returns the MP3::Tag object

=item B<calculate_gapless()>

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

=back

=head1 OPTIONS

=over 4

lib/Music/Tag/MP3.pm  view on Meta::CPAN

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

=item ignore_apic

Ignore embedded picture.

=back

=head1 BUGS

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

Please use github for bug tracking: L<http://github.com/riemann42/Music-Tag-MP3/issues|http://github.com/riemann42/Music-Tag-MP3/issues>.

=head1 SEE ALSO

L<MP3::Tag|MP3::Tag>, L<MP3::Info|MP3::Info>, L<Music::Tag|Music::Tag>

=for readme continue

=head1 SOURCE

Source is available at github: L<http://github.com/riemann42/Music-Tag-MP3|http://github.com/riemann42/Music-Tag-MP3>.

=head1 AUTHOR 

Edward Allen III <ealleniii _at_ cpan _dot_ org>