Hydrogenaudio Knowledgebase - User contributions [en]

Foobar2000:Components/Masstagger (foo masstag)

2008-11-01T18:18:29Z

Yandexx: fixed links to the new website

{{fb2k}}
{{Foobar Component Infobox
| name = foo_masstag
| screenshot =
| caption = Masstager
| maintainer = Official
| stable_release = 1.6
| preview_release =
| foobar_version = 0.9.4.x
| use = Tagging
| license = -
| website = [http://www.foobar2000.org/?page=Download]
| discussion_thread =
}}
'''Masstagger'''

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].

The Masstagger component is no longer under active development - most of its functionality has been split between the File Operations component (included with foobar2000 0.9.5 and newer), the [[Foobar2000:Properties|Properties dialog]] and the [http://www.foobar2000.org/?page=Download Quick Tagger component].

Masstagger's main limitation is lack of the ability to preview results of tag processing operations before writing new tags to your files. The [[Foobar2000:Properties|Properties dialog]] on the other hand lets you see new tag contents first so any mistakes are easily corrected without having to backup your tags/files or verify whether you're getting correct results on a smaller sample first.

== Available actions ==

=== Add value ===
Adds desired tag field and sets it to whatever you enter in the masstagger input window.

=== Auto track number ===
This gives the track number according to the order of the files in the selection.

=== Copy value ===
Copies one tag field to another.

=== Format value from other fields ===
This is where it becomes interesting. This option lets you enter a specific [[Foobar2000:Titleformat_Introduction|title formatting]] pattern for any tag field you wish to edit or create.

'''Note''' that when using complex formatting patterns I would recommend to first format a temporary %temp% tag with the desired pattern and then copy that one into the value that you wish. Afterwards you can remove the temp value. When processing a large batch of files you could probably just do a test run on one of the files and then do the rest in one go. Think about what you are doing beforehand though. After all I don't want to be held responsible for messing up anyones music collection.

''I will explain how to create formatting strings for different situations further down .''

=== Guess values from filename ===
Guesses values from filename and lets you enter a certain formatting pattern for it. For example if your files are named artist - album_title.

Enter
%artist% - %album%_%title%
as formatting pattern.

=== Guess values from other fields ===
Guesses values from other tags and lets you enter a certain fromatting pattern for it. For example if your files are tagged artist / title in the title field.

=== Input data (one line per track) ===
Enter the data for each song with the pattern indicated, line by line, (one line per song as it is said). Don't worry about the length, the lines could be very long (only adds a vertical scroll bar if it is too long).

=== Remove all fields ===
Removes all tag fields (who would have guessed)

=== Remove all except for... ===
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%;etc

=== Remove field ===
Removes desired tag field.

=== Set value ===
Sets desired tag field (artist, album,custom,etc) to whatever you enter in the masstagger input window.

=== Split multiple artist field ===

'''Note''' that it is possible to perform several of these actions at once and in that case the order of those actions can be very important. So removing field A before copying it to field B is probably a bad Idea and should be performed the other way around, etc.

== Writing format strings for the masstager ==

'''Extracting Information from Relative File Paths:'''

As suggested I have included a small section on how to extract different values from their relative file paths. To do so I will use the following example path to extract information from

''...\Genre\Artist\Album[Date]\01_Title.mpc''

'''sets title:'''

%_filename% returns title as 01_Title.mpc and

$puts(char,_)$puts(tag,%_filename%)
$puts(spacer,$strchr($get(tag),$get(char)))
$trim($right($get(tag),$sub($len($get(tag)),$get(spacer))))
returns title as Title.mpc

'''sets album:'''

$directory(%_path%,1) returns title as Album[Date]

$puts(char,'[')$puts(tag,$directory(%_path%,1))
$puts(spacer,$strchr($get(tag),$get(char)))
$trim($left($get(tag),$sub($get(spacer),1)))
returns album as Album

'''NOTE:''' that the [ is quotes as '[' , the reason for this is for it to be recognized as a character and not as a command syntax, you will probably have to ommit the quotation marks for most other characters.

'''sets artist:'''

$directory(%_path%,2) returns artist as Artist

'''sets genre:'''

$directory(%_path%,3) returns genre as Genre

'''
sets tracknumber:'''

$num($left(%_filename%,2),2) returns tracknumber as 01

Obviously a lot more is possible, but then this was just supposed to be a short introduction. I would say simply copy a few of your files, and play around with it.

== The Rename Files Dialog ==

The rename files dialog enables you to automatically rename your files according to your metadata tags in an automated way. You will first need to select all the tracks you want to rename and then right click and select: Masstagger/rename files.

Select in the masstagger dialog which output directory you mant to use and wether to generate subdirectories according to the / \ characters. I will give a few examples for renaming strings below.

'''Examples:'''

To rename your files to "tracknumber_title.ext (i.e. 08_The Glass Bead Game.mpc)" you will need to enter the following syntax in the Output file name format field

%tracknumber%_%title%
No need to create subdirectories in this case.

To rename your files to "/artist - album/title.ext (i.e. Thievery Corporation - Sounds of the Thievery Hi-Fi/08_The Glass Bead Game.mpc) and create the appropriate subdirectories you will need the following syntax

/%artist% - %album%/%tracknumber%_%title%
In this case make sure the "create subdirectories" checkbox is ticked.

To rename your files to "/artist/album/tracknumber_title.ext (i.e.: /Thievery Corporation/Sounds of the Thievery Hi-Fi/08_The Glass Bead Game.mpc) use the following syntax

/%artst%/%album%/%tracknumber%_%title%

In case you generally make use of "album artist" tags (or anything similar) for various albums files you can replace %artist% with

$if2(%album artist%,%artist%)
in any of the above strings.

'''Note:'''
One reason why it is convenient to use the masstaggers rename files function is that this way Foobar2000's Media Library will automatically get updated to the current changes.

== Links ==

This page is based on picmixer's [http://www.hydrogenaudio.org/forums/index.php?showtopic=12302 Unofficial masstagger guide] on the foobar2000 forum.

You can find a tutorial with videos here [http://eolindel.free.fr/foobar0.9/masstut.php Unofficial masstagger tutorial]

Foobar2000:Preferences:Display

2006-06-13T20:23:51Z

Yandexx: some remake here

[[Image:Preferences-Display.png|thumb|Display page]]
The Display page and its subpage contain options to change the appearance of foobar2000. The most important option on the Display page itself is the user interface selection.

== Options ==

=== User interface module ===

This option selects the active user interface. Only the Default User Interface is installed by default. foobar2000 has to be restarted before changes in this option take effect.

=== Misc. settings ===
==== VBR bitrate updates per second ====

This option affects how often the dynamic bitrate for variable bitrate formats is updated. Not all input components support reporting dynamic bitrate, but this will surely work for [[MP3]], [[Musepack]], [[Vorbis]] and [[AAC]].

==== Show keyboard shortcuts in menus ====

This option determines if keyboard shortcuts are shown in the main and context menus. This works for Default User Interface and Columns UI.

=== Double-width characters in title formatting ===

This option determines how double-width characters are treated in titleformatting scripts: whether to ignore them or to count as two regular characters.

== Subpages ==

The following subpages are present at all times:

* [[Foobar2000:Preferences:Context menu|Context menu]]
* [[Foobar2000:Preferences:Titleformatting|Titleformatting]]

The following subpages are present if you have Default User Interface (foo_ui_std) installed. As it's name implies, Default User Interface is installed by default.

* [[Foobar2000:Preferences:Default User Interface|Default User Interface]]

The following subpages are present if you have Columns UI (foo_ui_columns) installed. Columns UI is a third party component.

* [[Foobar2000:Preferences:Columns UI|Columns UI]]
** [[Foobar2000:Preferences:Columns UI:Playlist switcher|Playlist switcher]]
** [[Foobar2000:Preferences:Columns UI:Playlist view|Playlist view]]

Foobar2000:Preferences:General

2006-06-13T20:23:39Z

Yandexx: total overwrite

[[Image:Preferences-General.png|thumb|General page]]

This is the General page. It contains general foobar2000 configuration information.

== Options ==
=== Adding new files ===
These options deal with adding files using any way, whether it command line or drag and drop.
==== Sort incoming files by ====
This option defines the way files are sorted in playlist, just when added. By default, it's %path_sort%.
==== Restrict incoming files to ====
Type what filenames are allowed to be added. It supports ? and * symbols for masks. By default, it's * (asterisk, which means “all files”). As an example, if you set it to “*.MPC”, only MPC (Musepack) files will be added in future.
==== Exclude file types ====
Opposite to the previous options, this forbids filenames to be added. It supports ? and * symbols for masks. Empty by default. As an example, if you set it to “*.WAV”, no WAV files will be added in future.
==== Commandline ====
These options deal with adding files from commandline (all other ways than opening from player or using drag & drop).
===== Bring to front when adding new files from commandline =====
Does what it says. If unchecked, will add files in background, without popping.
===== Enqueue incoming files by default when adding from commandline =====
If marked, adding new files will not overwrite contents of playlist tracks are being added to.
===== Always send to playlist =====
By default, foobar2000 adds files to the active playlist, this can be overridden here by checking the option and typing the name of playlist, eg “Temp”, or “Default”.
=== Other ===
==== Enable user profile support ====
If checked, this checkbox will change the location where foobar2000.cfg is stored from the folder in which foobar2000.exe resides to the Application Data folder the local user's user folder.
==== Reset stop-after-current when stopping ====
One may use ''Playback > Stop after current'' in the main menu. Checking ''this'' flag will reset it after stopping.
==== Change selection with cursor when “playback / cursor follows playback” is enabled ====
Does what it says

== Subpages ==
* [[Foobar2000:Preferences:General:Keyboard Shortcuts|Keyboard Shortcuts]]

Foobar2000:Preferences

2006-06-13T19:33:51Z

Yandexx: even more cleanup and updates

[[Image:Fb2k-Preferences.png|thumb|foobar2000 v0.9.2 Preferences]]

Preferences in foobar2000 is the place where you do most of player's configuring.

Standard preferences dialogue for foobar2000 v0.9.2 is shown on the picture. You can access it through the foobar2000 main menu item (File > Preferences) or by hitting Ctrl+P (by default).

The sidebar on the left selects which page of preferences is displayed on the area to the right. The preferences page displayed on the screenshot is Components.

There are buttons at the bottom of the right area, which appear no matter what page you selected. ''Reset all'' will reset the whole configuration, including [[Foobar2000:Preferences:Media Library|Media Library]] and playlists of foobar2000. Pressing ''Reset page'' (new in v0.9) will reset only the current page's settings; this button is active only when component or page supports it. ''Help'' will open the corresponding wiki page on Hydrogenaudio, in the default browser. ''Save all'' is used to save the configuration, playlists and the Media Library, to remember the changes, in case foobar2000 crashes. And, finally, ''Close'' closes foobar2000 Preferences.

<small>Legacy preferences support here: [[Foobar2000:Preferences (v0.8.3)]]</small>

== Components ==

[[Image:Preferences-Components.png|thumb|Components page]]
This is the Components page. It contains a list of all of the components installed, and allows you to find out about the components. By clicking on the table headers, you can sort the list by component name, DLL name or version. For many of the components (for example, ''Standard DSP array''), if you double click an item in the list you get a popup with more detailed information.
{{clr}}

== Display ==

[[Image:Preferences-Display.png|thumb|Display page]]
This is the Display page. It allows for selection of user interface and several other display-related options.

View the Display sub-entries at [[Foobar2000:Preferences:Display]].
{{clr}}

== General ==

[[Image:Preferences-General.png|thumb|General page]]
This is the General page. It contains general foobar2000 configuration information.

View the General sub-entries at [[Foobar2000:Preferences:General]].
{{clr}}

== Playback ==

[[Image:Preferences-Playback.png|thumb|Playback page]]
This is the Playback page. It allows configuration of several playback-related options.

View more detailed information at [[Foobar2000:Preferences:Playback]].
{{clr}}

Foobar2000:Preferences

2006-06-13T19:15:00Z

Yandexx: cleanup and updates

[[Image:Fb2k-Preferences.png|thumb|foobar2000 v0.9.2 Preferences]]

Preferences in foobar2000 is the place where you do most of player's configuring.

Standard preferences dialogue for foobar2000 v0.9.2 is shown on the picture. You can access it through the foobar2000 main menu item (File > Preferences) or by hitting Ctrl+P (by default).

The sidebar on the left selects which page of preferences is displayed on the area to the right. The preferences page displayed on the screenshot is Components.

There are buttons at the bottom of the right area, which appear no matter what page you selected. ''Reset all'' will reset the whole configuration, including [[Foobar2000:Preferences:Media Library|Media Library]] and playlists of foobar2000. Pressing ''Reset page'' (new in v0.9) will reset only the current page's settings; this button is active only when component or page supports it. ''Help'' will open the corresponding wiki page on Hydrogenaudio, in the default browser. ''Save all'' is used to save the configuration, playlists and the Media Library, to remember the changes, in case foobar2000 crashes. And, finally, ''Close'' closes foobar2000 Preferences.

<small>Legacy preferences support here: [[Foobar2000:Preferences (v0.8.3)]]</small>

{{foobar2000:Preferences:Component Libraries}}

{{foobar2000:Preferences:Components}}

{{foobar2000:Preferences:General}}

{{clr}}

==Display==

[[Image:Preferences-Display.png|thumb|Display page]]

This is the Display page. It allows for selection of user interface and several other display-related options.

View the Display sub-entries at [[Foobar2000:Preferences:Display]].

{{clr}}

==Playback==

[[Image:Preferences-Playback.png|thumb|Playback page]]

This is the Playback page. It allows configuration of several playback-related options.

View more detailed information at [[Foobar2000:Preferences:Playback]].
{{clr}}

File:Preferences-General.png

2006-06-13T18:38:45Z

Yandexx:

File:Preferences-ContextMenu.png

2006-06-13T18:38:05Z

Yandexx:

File:Preferences-Components.png

2006-06-13T18:37:00Z

Yandexx:

Multichannel

2005-02-04T11:18:46Z

Yandexx:

'''Multichannel''' means that audio stream contains more that two audio channels.

It is not supported by the following formats: [[MP2]], [[MP3]], [[Musepack]].

It ''is'' supported by [[Ogg Vorbis]], [[AAC]].