musictag

musictag -- Quick access to Music::Tag features

SYNOPSIS

        musictag --preset "clean" /path/to/mp3/file.mp3

This will perform all cleanup operations on mp3 file.

OPTIONS

--stdin

Take filenames from standard input in addition to command line.

--preset=s

Choose a preset list of options. Currently the following presets are defined by default

clean

Is the equivalent of --plugin="File,MusicBrainz,Amazon,Lyrics" --keepmtime

safeclean

Is the equivalent of --plugin="File,MusicBrainz,Amazon,Lyrics" --keepmtime --safe

brainz

Is the equivalent of --plugin="MusicBrainz"

brainzsort

Is the equivalent of --plugin="File,MusicBrainz" --move=1 --dest="."

--plugin

Specify a plugin to add (input and outpout). Plugin options can be expressed in the form option=value. For example, to use Amazon with the German store, try

        --plugin="Amazon:Locale=de"

--outputplugin

Specify an output plugin. This is like --plugin except that it is ONLY used for output. For example, if you wanted to write cover art to a file but not read from a file you would use

    --plugin="Amazon" --outputplugin="File"

--inputplugin=s@

Specify an input plugin. This is like --outputplugin for input.

--pluginoption=s%

Specify additional options for all plugins. These optons are specified in key-value form. For example

        --plugin="Amazon,MusicBrainz" --pluginoptions="trust_title=1"

Would set the trusttitle option in both Amazon and MusicBrainz.

--nochange

Do not change the music file. Output plugins are still processed, just not the default plugin associated with the file extension.

--trust_title

Trust title (over track number). Used by MusicBrainz and Amazon plugins.

--trust_track

Trust track number (over title). Used by MusicBrainz and Amazon plugins.

--trust_time

Trust track time more. Used by MusicBrainz and Amazon plugins.

--trust_totaltracks

Trust total number of tracks. Used by MusicBrainz and Amazon plugins.

--striptags

Remove tag from file before writing new tag. Only used by MP3::Tag at the moment. Useful to convert from id3v2.4 to id3v2.3 or to clean up cruft from tags.

--safe

Do not change artist, album, title, and track number. Useful if all you want is a cover, and don't want to risk changing these.

--verbose

Produce more output.

--quiet

Shut up already.

--keepmtime

Attempt to keep mtime after tag change. Rarely works and requires you to run as root.

--sleeptime=f

Sleep between iterations. Keeps you from hammering Amazon or MusicBrainz.

--lyricsoverwrite

Overwrite lyrics already saved.

--coveroverwrite

Overwrite cover artwork already saved.

--forcechange

Resave tag no matter what.

--printinfo

Dump raw tag info to stdout. Very useful.

--getinfo=s

Get a specific tag info. Great for scripts.

--move

Move file to sorted location. If --move is set and a --dest is set, will sort your files. For example:

        musictag --move --dest="/nicely/sorted/" /poorly/sorted

This will resort the whole folder.

--cp

Copy file to sorted location. Same as move but copies.

--ln

Link file to sorted location. Same as move but links.

--lns

Symbolic link file to sorted location. Same as move but uses symbmolic links.

--dest=s

Set root path for sorted location. Will sort files in Artist/Album.

--nospace

sort without spaces.

--sort_regex=s

Regex of characters to convert to underscore in filenames when sorting

--help

Quick and dirty help.

--longhelp

Help file with more detail.

Tag Set Options

Setting any of these will set the equivalent tag manually.

--track=i

--disc=i

--totaltracks=i

--totaldiscs=i

--secs=i

--duration=i

--artist=s

--album=s

--title=s

--comment=s

--tracknum=s

--year=s

--releasedate=s

--sortname=s

--albumartist=s

--albumartist_sortname=s

--mb_artistid=s

--mb_albumid=s

--mb_trackid=s

--album_type=s

--artist_type=s

--lyrics=s

--picture=s

--url=s

--genre=s

--discnum=s

--tempo=s

--label=s

--encoder=s

--compilation=s

--composer=s

--copyright=s

--rating=s

--lastplayed=s

--playcount=s

--filename=s

--asin=s

--recorddate=s

--country=s

--mip_puid=s

--originalartist=s

--countrycode=s

--artist_start=s

--artist_end=s

--encoded_by=s

--songkey=s

--disctitle=s

--booklet=s

CONFIGURATION FILE

Configuration file is located at ~/.musictag/default.conf. See sample/default.conf for details.

SEE ALSO

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

AUTHOR

Edward Allen III <ealleniii _at_ cpan _dot_ org>

COPYRIGHT

Copyright (c) 2007,2008 Edward Allen III. Some rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the Artistic License, distributed with Perl.