NAME

Music::Tag::MusicBrainz - Plugin module for Music::Tag to get information from MusicBrainz database.

SYNOPSIS

	use Music::Tag

	my $info = Music::Tag->new($filename);
   
	my $plugin = $info->add_plugin("MusicBrainz");
	$plugin->get_tag;

	print "Music Tag Track ID ", $info->mb_trackid();

DESCRIPTION

This plugin gathers additional information about a track from www.musicbrianz.org, and updates the Music::Tag object.

Music::Tag::MusicBrainz objects must be created by Music::Tag.

REQUIRED DATA VALUES

artist

USED DATA VALUES

album

This is used to filter results.

releasedate

This is used to filter results.

totaltracks

This is used to filter results.

title

title is used only if track is not true, or if trust_title option is set.

tracknum

tracknum is used only if title is not true, or if trust_track option is set.

SET DATA VALUES

album

title

title is set only if trust_track is true.

track

track is set only if track is not true or trust_title is true.

releasedate

METHODS

get_tag()

Updates current Music::Tag object with information from MusicBrainz database.

Same as $mbplugin->artist_info() && $mbplugin->album_info() && $mbplugin->track_info();

artist_info()

Update the Music::Tag object with information about the artist from MusicBrainz.

album_info()

Update the Music::Tag object with information about the album from MusicBrainz.

track_info()

Update the Music::Tag object with information about the track from MusicBrainz.

mb_cache()

Returns and optionally sets a reference to the Cache::FileCache object used to cache requests.

default_options()

Returns hash of default options for plugin

required_values()

A list of required values required for get_tag() to work.

set_values()

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

OPTIONS

prefered_country

If multiple release countries are available, prefer this one. Default is 'US'.

min_artist_score

Minimum artist score for a match. Default is 1.

min_album_score

Minimum album score for a mach. Default is 17. Raise if you get too many false positives.

min_track_score.

Minimum track score. Default is 3.

ignore_mbid

If set, will ignore any MusicBrainz ID values found.

trust_time

If set, will give high priority to track duration in matching

trust_track

If set, will give high priority to track number in matching

trust_title

If set, will give high priority to title in matching.

skip_seen

If set, will not perform a MusicBrainz lookup if an mb_trackid is set.

ignore_multidisc_warning

If set, will enable use of MusicBrainz standards to get disc numbers.

mb_host

Set to host for musicbrainz. Default is www.musicbrainz.org.

BUGS

Sometimes will grab incorrect info. This is due to the lack of album level view when repairing tags.

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

SEE ALSO

WebService::MusicBrainz, Music::Tag, www.musicbrianz.org

SOURCE

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

AUTHOR

Edward Allen III <ealleniii _at_ cpan _dot_ org>

COPYRIGHT

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

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.

cpanm Music::Tag::MusicBrainz

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