Editing Foobar2000:Components/Masstagger (foo masstag)

Jump to: navigation, search

Warning: You are not logged in.

Your IP address will be recorded in this page's edit history.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
{{DISPLAYTITLE:foobar2000:Components/Masstagger (foo_masstag)}}
+
{{fb2k}}
 
{{Foobar Component Infobox
 
{{Foobar Component Infobox
| name                 = Masstagger
+
| name = foo_masstag
| screenshot           = [[Image:Foobar2000-Masstagger.png|256px]]
+
| screenshot =  
| caption             =  
+
| caption = Masstager
| module_name          = foo_masstag
+
| maintainer = Official
| developer            = Peter Pawlowski
+
| stable_release = 1.7
| stable_release      = 1.8.4
+
| preview_release =  
| stable_release_date  = 2009-09-18
+
| foobar_version = 0.9.5.x
| foobar2000_version  = 1.1
+
| use = Tagging
| use                  = Tagging
+
| license = -
 +
| website = [http://www.foobar2000.org/?page=Download]
 +
| discussion_thread =  
 
}}
 
}}
 +
= Masstagger =
 +
[[Image:Foobar2000-Masstagger.png]]
  
'''Masstagger''' is an advanced tool for editing the information of tags in multiple files.
+
Masstagger is an advanced tool for editing the information of tags in multiple files.
 +
'''Note:''' It's not available as part of foobar2000 0.9.5 or newer installers. It is still however available from the [http://www.foobar2000.org/?page=Download official components page].
  
Masstagger's main limitation is lack of <abbr title="What You See Is What You Get">WYSIWYG</abbr> editing of tags, making it inefficient for typical tag editing scenarios. You should use the [[Foobar2000:Properties|Properties dialog]] instead unless you want to be able to quickly run predefined complex tagging tasks on your files.
+
Masstagger's main limitation is lack of WYSIWYG editing of tags, making it inefficient for typical tag editing scenarios. You should use the [[Foobar2000:Properties|Properties dialog]] instead unless you want to be able to quickly run predefined complex tagging tasks on your files.
 
+
{{panel|'''Note:''' Masstagger is not available as part of foobar2000 0.9.5 or newer installers.|color=yellow}}
+
  
 
== Basic usage ==
 
== Basic usage ==
Line 25: Line 28:
  
 
The "scripts" box contains commands that allow you to save the current chain of actions or restore a chain of actions that was saved earlier.
 
The "scripts" box contains commands that allow you to save the current chain of actions or restore a chain of actions that was saved earlier.
 
 
There are two ways to store Masstagger scripts:
 
There are two ways to store Masstagger scripts:
 
* In foobar2000 configuration - by using the "Save" / "Load" etc buttons - you can quickly load those scripts later, as well as access them directly from the "Tagging" / "Scripts" submenu of the context menu, as well as access them with [[Foobar2000:Preferences:General:Keyboard Shortcuts|keyboard shortcuts]].
 
* In foobar2000 configuration - by using the "Save" / "Load" etc buttons - you can quickly load those scripts later, as well as access them directly from the "Tagging" / "Scripts" submenu of the context menu, as well as access them with [[Foobar2000:Preferences:General:Keyboard Shortcuts|keyboard shortcuts]].
Line 44: Line 46:
 
=== Copy value ===
 
=== Copy value ===
 
Copies one tag field to another.
 
Copies one tag field to another.
 
===Embed cuesheet===
 
This action looks for a cuesheet named %filename%.cue or %filename_ext%.cue in the same folder as the file being processed and embeds it.
 
  
 
=== Format value from other fields ===
 
=== Format value from other fields ===
This action lets you enter a specific [[Foobar2000:Title Formatting Introduction|title formatting]] pattern for any tag field you wish to edit or create.
+
This is where it becomes interesting. This option lets you enter a specific [[Foobar2000:Title Formatting Introduction|title formatting]] pattern for any tag field you wish to edit or create.
  
In addition to standard title formatting fields, starting with version 1.8.2 you can use %now% to fetch current system time.
 
  
 
=== Guess values from filename ===
 
=== Guess values from filename ===
Line 71: Line 69:
  
 
=== Remove all fields ===
 
=== Remove all fields ===
Removes all tag fields.
+
Removes all tag fields (who would have guessed)
  
 
=== Remove all except for... ===
 
=== Remove all except for... ===
Removes all fields except for the ones that you specify. For an example, specify "title;album;artist" to remove all fields other than title, album and artist.
+
Does just as it says, removes all values and lets you specify wich ones not to remove in a second field in the following pattern ie.: "artist;title"
  
 
=== Remove field ===
 
=== Remove field ===
 
Removes desired tag field.
 
Removes desired tag field.
  
=== Remove values... ===
+
=== Set value ===
Opposite of "Add value". Removes matching values of the specified field. Useful when dealing with multiple genre values for an example.
+
Sets desired tag field (artist,album,custom,etc) to whatever you enter in the masstagger input window.
 
+
=== Replace values... ===
+
Replaces matching values of the specified field with the specified value. Useful for mass-fixing inconsistent tagging, especially when dealing with multi-value fields such as artist or genre, since only the matching value gets altered.
+
 
+
=== Set value... ===
+
Sets desired tag field (artist,album,etc) to the specified value.
+
 
+
=== Split field by separator... ===
+
Splits values of the specified field according to the specified separator string. For an example, if your tags have ARTIST fields formatted as "person1 & person2" instead of correct multiple values, you can use this action to split generate multiple values, by specifying "&" as the separator string.
+
 
+
=== Split multiple artist fields ===
+
If the artist field value contains characters such as "," or "&", the value gets split into multiple values accordingly.
+
 
+
Note: This is equivalent to having two "Split field by separator..." actions, both with field set to "ARTIST", one with separator set to "," and the other with separator set to "&".
+
 
+
== Notes on upgrading from older (pre-1.7) Masstagger versions ==
+
Various functionality that is now available through other components has been removed.
+
* File moving functionality - now available through the [[Foobar2000:File_operations|File Operations component]].
+
* Copying tags between tracks - see: [[Foobar2000:How to transfer tags between two sets of tracks|How to transfer tags between two sets of tracks]].
+
 
+
== Command line interface ==
+
Masstagger provides extra [[Foobar2000:Commandline_Guide|command line switches]] for tag modifications. Version 1.8.4 of the component shows this information:
+
  Usage:
+
 
+
  /tag:help - displays this message
+
 
+
  /tag:<command1>[;<command2>;<command3>...] <file1> [<file2> <file3>...]
+
 
+
  Commands:
+
 
+
  <NAME>=<VALUE>
+
      Sets <NAME> field to <VALUE>, e.g. "/tag:title=test <file>".
+
      You can erase particular field by specifying empty value, e.g. "/tag:comment= <file>".
+
      You can also specify multiple values by separating them with \ character, e.g. "/tag:artist=name1\name2 <file>".
+
  AUTOTRACKNUMBER
+
      Sets TRACKNUMBER field of multiple files according to their order in commandline.
+
      E.g. "/tag:AUTOTRACKNUMBER <file1> <file2> <file3>" will assign TRACKNUMBER=1 to <file1>, 2 to <file2> and 3 to <file3>.
+
  FORMAT:<FIELD>:<SPEC>
+
      Formats <FIELD> using <SPEC>; see title formatting manual for more info how to use it.
+
      E.g. "/tag:FORMAT:COMMENT:"%ARTIST% - %TITLE%" <file>".
+
  GUESS:<PATTERN>:<SPEC>
+
      Guesses field values using <PATTERN>, according to <SPEC>.
+
      To perform "guess values from filename" action, use "/tag:GUESS:<PATTERN>:%_FILENAME% <file>".
+
      E.g. "/tag:GUESS:"%TRACKNUMBER%. %TITLE%":%_FILENAME% <file>".
+
  
==External links==
+
=== Split multiple artist field ===
* {{foobar2000|http://www.foobar2000.org/components/view/foo_masstag|Masstagger}}
+

Please note that all contributions to Hydrogenaudio Knowledgebase are considered to be released under the GNU Free Documentation License 1.2 (see Hydrogenaudio Knowledgebase:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

Cancel | Editing help (opens in new window)