Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tagmp3(1) [debian man page]

tagmp3(1)							    User manual 							 tagmp3(1)

NAME
tagmp3 - manipulate ID3v1 tags SYNOPSIS
tagmp3 [ -n ] mode [ format ] [ file ] ... DESCRIPTION
tagmp3 allows you to set and remove ID3v1 tags from mp3 files. Additionaly move mode can be used to move mp3 files according to their ID3v1 tag. An ID3v1 tag is a chunk of extra informations such as artist name, album and genre. ID3v1 tags are displayed by most mp3 players. MODE
show show file's ID3v1 tag. set sets file's ID3v1 tag according to format. move move file to a destination based on FORMAT. del remove file's ID3v1 tag if any. list displays numeric music genres along with their meaning. -h print a (not so) short help message. -v print version and exit. OPTIONS
-n Show what will be done, don't alter any file. FORMAT STRING
The format string is a character string composed of zero or more directives: ordinary characters (not %), which are not interpreted and conversion specifications, each of which results in the corresponding ID3v1 tag field substitution. Each conversion specification is introduced by the character %. The following lines describes each conversion specification along with its associated ID3v1 field. Special sequence %% is substituted with a single %. %A Artist Name %a Album Name %t Song Title %T Track Number %y Year %g Genre %c Comments format string for set mode For set mode the format string is a list of ID3v1 fields followed by a ':' (next chars are the field value) or a '?' (ask user for field value) example: tagmp3 set "%A:Pink Floyd %a:The Wall %t? %T?" *.mp3 For each mp3 of this directory, sets the artist name to Pink Floyd and the album to The Wall. For each file ask for the title and the track number. Leave the other fields untouched. Be aware that genre field require a numeric value. Known genres can be dis- played with the list mode. format string for move mode The format string is the destination path where each field identifier is substituted with the tag value. example: tagmp3 move "/home/foo/mp3/%A/%a/%T-%t.mp3" *.mp3 with the set example above will move all mp3 to "/home/foo/mp3/Pink Floyd/The Wall/{track}-{title}.mp3" If you prefer the "flat" naming scheme, you will use something like tagmp3 move "%A-%t.mp3" *.mp3 NOTES
move mode never overwrite files. move mode creates intermediate directories specified in the format string. Each directory creation is to be confirmed by the user. ID3v2 tags are not supported so far. If a file can't be moved ( wrong file type, ID3v1 tag absent or blank field , ...) then it is left untouched. Fake mp3 (i.e. Wave file with .mp3 extension) are moved into "fake-mp3/" directory in move mode. set mode refuses to tag them since this would add noisy artifact at the end of the song. BUGS
Plenty of :) For move mode, source and destination must reside on the same file system / partition. AUTHOR
Laurent Alacoque <laureck@users.sourceforge.net> CopyLeft 2001 Bugs, patch, infos, new releases, girls, money go to : http://mpgtx.sourceforge.net/ Linux APRIL 2001 tagmp3(1)

Check Out this Related Man Page

ID3REN(1)						      General Commands Manual							 ID3REN(1)

NAME
id3ren - Reads and writes ID3 tags from mp3 files. SYNOPSIS
id3ren [-help] [-song=SONG_NAME] [-artist=ARTIST_NAME] [-album=ALBUM_NAME] [-year=YEAR] [-genre={# | GENRE}] [-comment=COMMENT] [-track=TRACK] [-showgen] [-searchgen={# | GENRE}] [-default=DEFAULT] [-copytagfrom=FILE [-copysong] [-copyartist] [-copyalbum] [-copyyear] [-copygenre] [-copycomment] [-copytrack] [-copyall] ] [-quick] [-noalbum] [-nocomment] [-noyear] [-nogenre] [-notrack] [-tag] [-edit] [-notagprompt | -showtag | -striptag | -tagonly] [-nocfg] [-log] [-quiet] [-verbose] [-defcase | -lower | -upper] [-remchar=CHARS] [-repchar=CHARS] [-space=STRING] [-tagfromfilename | -tagffn] [-tagtemplate=TAGTEMPLATE] [-template=TEMPLATE] [FILE1 FILE2.. | WILDCARDS] COPYRIGHT
id3 Renamer (C) Copyright 1998 by Robert Alto (badcrc@tscnet.com) (C) Copyright 2001 Christophe Bothamy (cbothamy@free.fr) DESCRIPTION
id3ren is used to rename batches of mp3 files by reading the ID3 tag at the end of the file which contains the song name, artist, album, year, and a comment. The secondary function of id3ren is a tagger, which can create, modify, or remove ID3 tags. OPTIONS -album ALBUM_NAME Sets the album name to use when tagging files. All files will be tagged with this album name without prompting. -album=ALBUM_NAME Sets the album name to use when tagging files. All files will be tagged with this album name without prompting. -artist=ARTIST_NAME Sets the artist name to use when tagging files. All files will be tagged with this artist name without prompting. -comment=COMMENT Sets the comment to use when tagging files. All files will be tagged with this comment without prompting. -copyalbum Copies the album field from the source file tag set by -copytagfrom -copyall Copies all the fields from the source file tag set by -copytagfrom -copyartist Copies the artist field from the source file tag set by -copytagfrom -copycomment Copies the comment field from the source file tag set by -copytagfrom -copygenre Copies the genre field from the source file tag set by -copytagfrom -copysong Copies the song field from the source file tag set by -copytagfrom -copytagfrom=FILE Sets the filename to copy tag field from. -copytrack Copies the track field from the source file tag set by -copytagfrom -copyyear Copies the year field from the source file tag set by -copytagfrom -defcase Use the default case of characters from the ID3 tag when renaming files. This is default. -default=DEFAULT Sets the default field to be used only when renaming if a field is blank. Useful when renaming and creating "unknown" subdirecto- ries. Defaults to "unknown". -edit If a file already has a tag and you want to change just one specific field of the tag, use this option in conjunction with -tag and the option for the field you want to change. For example to change just the album name of a file: id3ren -tag -edit -album="New Album Name" sample.mp3 * This option is a toggle. -genre=# | GENRE_NAME Sets the genre to use when tagging files. All files will be tagged with this genre without prompting. To see a list of allowable genres use the -showgen argument. -genre accepts either the number of the genre as displayed with -showgen, or the name of the genre. -help Displays the help screen. -log Log most output to id3ren.log. * This option is a toggle. -lower Convert file names to lowercase characters. -noalbum Don't prompt for the album when adding a tag. * This option is a toggle. -nocfg Don't try reading any config files, even if they exist. * This option is a toggle. -nocomment Don't prompt for a comment when adding a tag. * This option is a toggle. -nogenre Don't prompt for a genre when adding a tag. * This option is a toggle. -notagprompt Never prompt for tag information. Files without tags are skipped. * This option is a toggle. -notrack Don't prompt for the track number when adding a tag. * This option is a toggle. -noyear Don't prompt for the year when adding a tag. * This option is a toggle. -quick Automatically sets -noalbum, -nocomment, and -noyear. -quiet Run quietly, displaying only errors or prompts. * This option is a toggle. -remchar=CHARS CHARS indicates a string of characters that will be removed from the filename if found. -repchar=CHARS CHARS indicates a string of characters, EACH followed by the character to replace it with. For example, to replace all plus '+' signs with a hyphen all '&' with '_', you would use '-repchar +-&_'. -searchgen=# | GENRE Searches the list of genres and displays either the genre name corresponding to #, or shows all substring matches of GENRE. -showgen Displays all the music genres currently in the program. -showtag Display the tags for the specified files. No renaming is performed. -song=SONG_NAME Sets the song name to use when tagging files. All files will be tagged with this song name without prompting. -space=PSTRING Change all spaces in the renamed file to STRING. To remove all spaces, use -striptag Remove the tags for the specified files. * This option is a toggle. -tag Always ask for a tag, even if the file already has one. * This option is a toggle. -tagfromfilename, -tagffn Use informations from the filename when tagging. See tagtemplate. * This option is a toggle. -tagonly Don't rename any files, just ask for tag information. Note that -tagonly only asks for tag information on files that don't have a tag already. To have it ask for a tag on all files, use with -tag. * This option is a toggle. -tagtemplate=TEMPLATE Use TEMPLATE as the basis for tagging files. The default template used is '[%a]-[%s].mp3'. Identifiers that can be used in the template are: %a - Artist name %c - Comment %s - Song name %t - Album title %n - Track Number %y - Year %g - Genre %d - Dummy It is a VERY good idea to have fixed separators between fields. -template=TEMPLATE Use TEMPLATE as the basis for renaming files. The default template used is '[%a]-[%s].mp3'. Identifiers that can be used in the template are: %a - Artist name %c - Comment %s - Song name %t - Album title %n - Track Number %y - Year %g - Genre -track=TRACK Sets the track number to use when tagging files. All files will be tagged with this track number without prompting. TRACK must be an integer between 1 and 99. -upper Convert file names to uppercase characters. -verbose Display more messages than usual. * This option is a toggle. -year=YEAR Sets the year to use when tagging files. All files will be tagged with this year without prompting. And of course the program accepts wildcards for filenames. FILES
*.mp3 All your mp3 files SEE ALSO
lame(1), xmms(1), mpg123(1), mp3blaster(1) BOGUS
If you have questions, comments, or bug reports, please contact cbothamy@free.fr To get the latest version, please visit http://cboth- amy.free.fr/projects/id3ren/ 14 july 2001 ID3REN(1)
Man Page

Featured Tech Videos