Possible usage for command line:
tag single file
: UMTagger.exe tag -file=<file> [options]
tag files in folder
: UMTagger.exe tag -path=<folder> [options]
rename single file
: UMTagger.exe rename -file=<file> -pattern=<pattern>
rename files in folder
: UMTagger.exe rename -path=<folder> -pattern=<pattern>
[ tag mode ]
use lastfm to retrieve tag information directly from lastfm remote services.
Internet connection required. Edit umtagger.ini file
to configure connection if behind proxy.
t|tagmode=<<a t T r R y p i g m>>
select which tag field to overwrite.
r = album
R = album artist
t = title
T = track artist
y = year
p= position / track
i = front cover image (in manual
mode, if -image is not specified the picture tag will be removed)
g = genres
m = musicbrainzId (only with lastfm mode)
ALL = equivalent of atrpigm
year (ex. 2013)
a valid image path
genres comma separated (ex. rock, hard rock)
track - filename match mode, valid values are n or p
file extension to process, other will be ignored. default extension is .mp3
about track / filename match
this option is used when using lastfm
and path mode, in order to achieve which file is relative to the track's album returned by lastfm.
Just some examples:
using lastfm and path mode, search for artist:"Slayer" and album:"Reign in Blood" will return a list of tracks:
01 - Angel of Death
02 - Piece by piece
03 - Necrophobic
Ultimate Music Tagger will find a corrispondence match between each track and the filename found on the path.
file / track corrispondence is given by the name of the file and the track title
for example, "Angel Death.mp3" file be tagged as the first track, "Necrofobic" as the third and so on.
file / track corrispondence is given by the number within the filename and the track position
for example, file "Track 02.mp3" or "02 - Ride The Lightning.mp3" is matched as the second track.
generally speaking, use n
mode when filename is mostly like song title;
mode when having filename with "Track 01" "Track 02" under working folder.
[ rename mode ]
rename target(s) with specified pattern.
rename file or folder
song title = %t %title
artist = %a %artist
album = %r %album
year = %y %d %year
track position =%p %pos
"%p - %t" = "01 - Taxman.mp3"
"%a %r - %t [%y]" = "The Beatles Revolver - Taxman .mp3"
"foo %t %p" = "foo Taxman 01.mp3"
Performing Lastfm search
be accurate as possible
when performing lastfm search.
For example, doing a search with:
artist:Beatles , title:Walrus
artist:Beatles , title:The Walrus
return no valid track info.
This is because correct title to perform search is:
"I am The Walrus"
Tag list mode
connection behind proxy
- selection: Tag associative between selected left list of tracks and files
- name: Tag selected files with matched track name on the left list (see
tag_name for details)
- position: Tag selected files with matched track position and number within the filename (see
tag_position for details)
file under executable folder to edit proxy settings.
an example of multiple files tag with mode=lastfm