Edward J. Allen III > Music-Tag > bin/musictag

Download:
Music-Tag-0.4103.tar.gz

Annotate this POD

CPAN RT

New  2
Open  1
View/Report Bugs
Source  

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.

syntax highlighting: