Difference between revisions of "Foobar2000:Properties"

From Hydrogenaudio Knowledgebase
Jump to: navigation, search
m (See also: Added link to "Classic Properties Dialog" component.)
(Updated majority of page to reflect changes made in foobar2000 v1.5.)
 
Line 1: Line 1:
[[Image:foobar2000 Properties dialog - Metadata tab.png|thumb|Metadata tab.]]
+
[[File:foobar2000 Properties dialog - Metadata tab.png|thumb|Metadata tab.]]
[[Image:foobar2000 Properties dialog - Details tab.png|thumb|Details tab.]]
+
The '''Properties''' dialog allows a user to view and modify the [[metadata]] of one or more audio files.
The '''Properties''' dialog allows a user to view and modify the metadata of one or more audio files.
+
  
 
To open the Properties dialog, select one or more tracks (e.g. in a playlist), right-click, choose "Properties" from the context menu.
 
To open the Properties dialog, select one or more tracks (e.g. in a playlist), right-click, choose "Properties" from the context menu.
Line 7: Line 6:
 
To commit any edits you've made to file tags, click either the {{button|OK}} button (to close the dialog) or the {{button|Apply}} button (to save then continue viewing/editing).
 
To commit any edits you've made to file tags, click either the {{button|OK}} button (to close the dialog) or the {{button|Apply}} button (to save then continue viewing/editing).
  
== Metadata tab ==
+
==Tabs==
 +
===Metadata===
 
All fields shown on the Metadata tab can be edited, either individually or by selecting more than one.
 
All fields shown on the Metadata tab can be edited, either individually or by selecting more than one.
  
Line 14: Line 14:
 
Although only 13 standard fields are enabled by default – with non-standard field names being shown in an unformatted state, e.g. {{code|<GROUPING>}} – additional "standard" fields can be added under the [[#Advanced preferences|Advanced preferences]] page.
 
Although only 13 standard fields are enabled by default – with non-standard field names being shown in an unformatted state, e.g. {{code|<GROUPING>}} – additional "standard" fields can be added under the [[#Advanced preferences|Advanced preferences]] page.
  
== Details tab ==
+
===Details===
 +
[[File:foobar2000 Properties dialog - Details tab.png|thumb|Details tab.]]
 
The Details tab is read-only, and is only used for showing metadata that has been generated by other means.
 
The Details tab is read-only, and is only used for showing metadata that has been generated by other means.
  
Line 21: Line 22:
 
; General
 
; General
 
: Information specific to the audio format/codec/tool that the file has been encoded with.
 
: Information specific to the audio format/codec/tool that the file has been encoded with.
; ReplayGain
 
: Track and album ReplayGain values.
 
: Should manual editing of these values be required, right-click the files in the main foobar2000 window and select "ReplayGain → Edit ReplayGain information".
 
 
; Playback Statistics
 
; Playback Statistics
 
: Displays playback information recorded by the [[Foobar2000:Components/Playback Statistics (foo_playcount)|Playback Statistics]] component.
 
: Displays playback information recorded by the [[Foobar2000:Components/Playback Statistics (foo_playcount)|Playback Statistics]] component.
  
== Tools menu ==
+
===ReplayGain===
 +
[[File:foobar2000 Properties dialog - ReplayGain tab.png|thumb|ReplayGain tab.]]
 +
The [[ReplayGain]] tab allows editing of the select tracks' ReplayGain data, and the following options are available from the context menu:
 +
 
 +
; Clear ReplayGain information
 +
: Clears ReplayGain information on all tracks.
 +
; Scan track gain
 +
: Scans track gain on all tracks.
 +
; Scan album gain (single album)
 +
: Scans track and album gain on the selected tracks; treats the tracks as one album.
 +
; Skip scanning tracks/albums with info present
 +
: Toggles whether tracks that already have ReplayGain information should be excluded from scans.
 +
 
 +
The ReplayGain fields shown are also editable.
 +
 
 +
===Artwork===
 +
[[File:foobar2000 Properties dialog - Artwork tab.png|thumb|Artwork tab.]]
 +
The Artwork tab allows the following images to be added or removed:
 +
* Front Cover
 +
* Back Cover
 +
* Artist
 +
* Disc
 +
* Icon
 +
 
 +
Once added, image size, dimensions and format are shown.
 +
 
 +
==Tools menu==
 
[[Image:Foobar2000-properties-toolsmenu.png|thumb|The standard Tools menu, without the "Load complete info" option visible.]]
 
[[Image:Foobar2000-properties-toolsmenu.png|thumb|The standard Tools menu, without the "Load complete info" option visible.]]
 
Clicking the {{button|Tools}} button displays the following menu options:
 
Clicking the {{button|Tools}} button displays the following menu options:
Line 42: Line 66:
 
; Automatically fill values...
 
; Automatically fill values...
 
: Allows you to automatically fill metadata values from file names / other metadata / other sources. [[Foobar2000:Properties/Automatically Fill Values|Read more...]]
 
: Allows you to automatically fill metadata values from file names / other metadata / other sources. [[Foobar2000:Properties/Automatically Fill Values|Read more...]]
; Load complete info
+
; ReplayGain
: Fully loads all metadata fields when the "[[#Partial info|Partial info shown]]" warning is visible.
+
: Show a menu with the same ReplayGain commands as on the [[#ReplayGain|ReplayGain tab]].
 
; Reload info
 
; Reload info
: Reloads displayed information from your files. Any unsaved edits that you've made will be lost.
+
: Discards any edits and reloads all info from tracks being worked with.
 
; Remove tags
 
; Remove tags
 
: For file formats that support optional tags such as ID3 or APE, those optional tags are completely stripped.
 
: For file formats that support optional tags such as ID3 or APE, those optional tags are completely stripped.
 
: Any metadata or ReplayGain information is removed from the files.
 
: Any metadata or ReplayGain information is removed from the files.
 +
; Optimize size
 +
: Optimizes file size, removing unnecessary padding inserted for efficient tag updates. Recommended only when you do not intends to edit tags on the file.
 
; Font...
 
; Font...
: Select the font, font style and font size for the Properties dialog.
+
: Configures font used by the Properties dialog and its sub-dialogs.
 +
; Additional settings
 +
: Opens the [[#Advanced preferences|Advanced preferences]] page.
  
== Partial info ==
+
==Partial info==
[[Image:foobar2000 Properties dialog - Partial info shown.png|thumb|"Partial info shown [?]" message.]]
+
[[File:foobar2000 Properties dialog - Partial info shown.png|thumb|"Partial info shown [?]" message.]]
{{panel|'''Note:''' The "partial info" function was introduced in foobar2000 v1.3.|color=yellow}}
+
{{panel|'''Note:''' The "partial info" function was introduced in foobar2000 v1.3, and removed in foobar2000 v1.5.|color=yellow}}
  
 
In certain situations, the Properties dialog shows only partial information about the selected tracks; fields considered too long to be cached by foobar2000 are replaced with a {{code|.}} (dot) character and "Partial info shown [?]" is displayed next to the '''Tools''' button.
 
In certain situations, the Properties dialog shows only partial information about the selected tracks; fields considered too long to be cached by foobar2000 are replaced with a {{code|.}} (dot) character and "Partial info shown [?]" is displayed next to the '''Tools''' button.
Line 62: Line 90:
 
When partial info is shown, any changes made to the affected fields will not be written to the file. In order to get complete properties dialog functionality, i.e. to view or edit the affected fields, click the {{button|Tools}} button (see above) and select '''Load complete info'''.
 
When partial info is shown, any changes made to the affected fields will not be written to the file. In order to get complete properties dialog functionality, i.e. to view or edit the affected fields, click the {{button|Tools}} button (see above) and select '''Load complete info'''.
  
== Copy and paste functionality ==
+
==Copy and paste functionality==
 
+
You can transfer metadata values between different fields (e.g. copy track titles to comments), between different tracks or even between different sets of tracks using copy / paste functionality of the Properties dialog. Simply select one or more metadata fields that you want to operate on, right-click them and choose one of copy / paste commands.
You can transfer metadata values between different fields (e.g.. copy track titles to comments), between different tracks or even between different sets of tracks using copy / paste functionality of the Properties dialog. Simply select one or more metadata fields that you want to operate on, right-click them and choose one of copy / paste commands.
+
  
 
The difference between "Paste" and "Paste Fields" commands is that "Paste" replaces currently selected fields' values with field values currently present in Windows Clipboard - regardless of names of fields that you copied before; "Paste Fields" behavior doesn't depend on current selection - it creates new fields with names and values present in Windows Clipboard - if fields with matching names already exist, they're overwritten. For an example: if you copy the "title" field, you can use the "Paste" command to put titles in the "comment" field, but the "Paste Fields" will always overwrite contents of the "title" field with copied values. "Paste Fields" is mainly intended for transferring full sets of metadata between different tracks.
 
The difference between "Paste" and "Paste Fields" commands is that "Paste" replaces currently selected fields' values with field values currently present in Windows Clipboard - regardless of names of fields that you copied before; "Paste Fields" behavior doesn't depend on current selection - it creates new fields with names and values present in Windows Clipboard - if fields with matching names already exist, they're overwritten. For an example: if you copy the "title" field, you can use the "Paste" command to put titles in the "comment" field, but the "Paste Fields" will always overwrite contents of the "title" field with copied values. "Paste Fields" is mainly intended for transferring full sets of metadata between different tracks.
Line 70: Line 97:
 
To completely transfer metadata between two groups of tracks, open the Properties dialog for the source group, select all metadata fields, right-click, choose "Copy"; then open the Properties dialog for the target group, select all metadata fields, choose "Remove" and then "Paste Fields" from the right-click menu. [[Foobar2000:How to transfer tags between two sets of tracks|Read more...]]
 
To completely transfer metadata between two groups of tracks, open the Properties dialog for the source group, select all metadata fields, right-click, choose "Copy"; then open the Properties dialog for the target group, select all metadata fields, choose "Remove" and then "Paste Fields" from the right-click menu. [[Foobar2000:How to transfer tags between two sets of tracks|Read more...]]
  
== Usage tips ==
+
==Usage tips==
 
+
 
You can open the Properties dialog for multiple tracks - by selecting a group of tracks in a playlist then choosing "Properties" from the context menu for an example. This lets you mass-edit tags of multiple tracks at once.
 
You can open the Properties dialog for multiple tracks - by selecting a group of tracks in a playlist then choosing "Properties" from the context menu for an example. This lets you mass-edit tags of multiple tracks at once.
  
Line 78: Line 104:
 
When editing tags of multiple tracks, double-clicking a field name - or choosing "Edit" from field's right-click menu - opens a dialog where you can see and edit each track's individual values of that field. You can also select multiple fields then use the "Edit" command to open a dialog where you can conveniently edit individual per-track values of each of those fields.
 
When editing tags of multiple tracks, double-clicking a field name - or choosing "Edit" from field's right-click menu - opens a dialog where you can see and edit each track's individual values of that field. You can also select multiple fields then use the "Edit" command to open a dialog where you can conveniently edit individual per-track values of each of those fields.
  
If your files have empty or incorrect tags but corrent artist/title/etc information is present in file or folder names, you can automatically transfer that information to tags using the "Automatically Fill Values..." command from the Tools menu. For an example, if your file naming scheme is "artist\album [date]\nn. title", you should set source to "File Names" and pattern to "%artist%\%album% [%date%]\%tracknumber%. %title%". [[Foobar2000:Properties/Automatically Fill Values|Read full article...]]
+
If your files have empty or incorrect tags but corrent artist/title/etc information is present in file or folder names, you can automatically transfer that information to tags using the "Automatically Fill Values..." command from the Tools menu. For an example, if your file naming scheme is "artist\album [date]\nn. title", you should set source to "File Names" and pattern to {{code|%artist%\%album% [%date%]\%tracknumber%. %title%"}}. [[Foobar2000:Properties/Automatically Fill Values|Read full article...]]
  
If you wish to go straight to the properties tab when opening the dialog - without additional clicking - you can hold shift while opening the dialog. This also applies to opening the dialog through keyboard shortcuts - if shift is a part of the keyboard combo used, the properties tab will be activated.
+
If you wish to go straight to the properties tab when opening the dialog - without additional clicking - you can hold {{key press|Shift}} while opening the dialog. This also applies to opening the dialog through keyboard shortcuts - if {{key press|Shift}} is a part of the keyboard combo used, the properties tab will be activated.
  
 
==Advanced preferences==
 
==Advanced preferences==
Line 87: Line 113:
  
 
; Always preload complete info up to N tracks
 
; Always preload complete info up to N tracks
: Specify how many track to pre-load metadata for. The default is "100".
+
: Specify how many track to pre-load metadata for.
 +
: Default: {{code|100}}
 
; Multiline fields
 
; Multiline fields
 
: Specify which fields can contain line breaks.
 
: Specify which fields can contain line breaks.

Latest revision as of 20:54, 6 December 2019

Metadata tab.

The Properties dialog allows a user to view and modify the metadata of one or more audio files.

To open the Properties dialog, select one or more tracks (e.g. in a playlist), right-click, choose "Properties" from the context menu.

To commit any edits you've made to file tags, click either the OK button (to close the dialog) or the Apply button (to save then continue viewing/editing).

Tabs[edit]

Metadata[edit]

All fields shown on the Metadata tab can be edited, either individually or by selecting more than one.

Clicking a field in the "Value" column will allow the user to make in-place changes, whereas double-clicking a field in the "Name" column will open the "Edit Value" dialog box. For individual files, the "Edit Value" box will only show the field name and the field value; for multiple files, "Single value" and "Individual values" tabs will be available.

Although only 13 standard fields are enabled by default – with non-standard field names being shown in an unformatted state, e.g. <GROUPING> – additional "standard" fields can be added under the Advanced preferences page.

Details[edit]

Details tab.

The Details tab is read-only, and is only used for showing metadata that has been generated by other means.

Location
Information on the selected files, such as file path, file size and modify date.
General
Information specific to the audio format/codec/tool that the file has been encoded with.
Playback Statistics
Displays playback information recorded by the Playback Statistics component.

ReplayGain[edit]

ReplayGain tab.

The ReplayGain tab allows editing of the select tracks' ReplayGain data, and the following options are available from the context menu:

Clear ReplayGain information
Clears ReplayGain information on all tracks.
Scan track gain
Scans track gain on all tracks.
Scan album gain (single album)
Scans track and album gain on the selected tracks; treats the tracks as one album.
Skip scanning tracks/albums with info present
Toggles whether tracks that already have ReplayGain information should be excluded from scans.

The ReplayGain fields shown are also editable.

Artwork[edit]

Artwork tab.

The Artwork tab allows the following images to be added or removed:

  • Front Cover
  • Back Cover
  • Artist
  • Disc
  • Icon

Once added, image size, dimensions and format are shown.

Tools menu[edit]

The standard Tools menu, without the "Load complete info" option visible.

Clicking the Tools button displays the following menu options:

Selection
Same as right-click menu commands for the currently-selected metadata fields.
Add new field...
Adds a new metadata field with any name that you specify.
Keyboard shortcut: Ctrl+N
Paste fields
See copy and paste functionality section below.
Keyboard shortcut: Ctrl+⇧ Shift+V
Auto track number
Automatically fills Track Number and Total Tracks fields, according to original order of tracks that you've opened the Properties dialog for. Tracks placed in different folders are assumed to be separate albums and are counted separately.
Automatically fill values...
Allows you to automatically fill metadata values from file names / other metadata / other sources. Read more...
ReplayGain
Show a menu with the same ReplayGain commands as on the ReplayGain tab.
Reload info
Discards any edits and reloads all info from tracks being worked with.
Remove tags
For file formats that support optional tags such as ID3 or APE, those optional tags are completely stripped.
Any metadata or ReplayGain information is removed from the files.
Optimize size
Optimizes file size, removing unnecessary padding inserted for efficient tag updates. Recommended only when you do not intends to edit tags on the file.
Font...
Configures font used by the Properties dialog and its sub-dialogs.
Additional settings
Opens the Advanced preferences page.

Partial info[edit]

"Partial info shown [?]" message.

In certain situations, the Properties dialog shows only partial information about the selected tracks; fields considered too long to be cached by foobar2000 are replaced with a . (dot) character and "Partial info shown [?]" is displayed next to the Tools button.

This is done for performance reasons, when loading complete info would make the Properties dialog take a long time to open.

When partial info is shown, any changes made to the affected fields will not be written to the file. In order to get complete properties dialog functionality, i.e. to view or edit the affected fields, click the Tools button (see above) and select Load complete info.

Copy and paste functionality[edit]

You can transfer metadata values between different fields (e.g. copy track titles to comments), between different tracks or even between different sets of tracks using copy / paste functionality of the Properties dialog. Simply select one or more metadata fields that you want to operate on, right-click them and choose one of copy / paste commands.

The difference between "Paste" and "Paste Fields" commands is that "Paste" replaces currently selected fields' values with field values currently present in Windows Clipboard - regardless of names of fields that you copied before; "Paste Fields" behavior doesn't depend on current selection - it creates new fields with names and values present in Windows Clipboard - if fields with matching names already exist, they're overwritten. For an example: if you copy the "title" field, you can use the "Paste" command to put titles in the "comment" field, but the "Paste Fields" will always overwrite contents of the "title" field with copied values. "Paste Fields" is mainly intended for transferring full sets of metadata between different tracks.

To completely transfer metadata between two groups of tracks, open the Properties dialog for the source group, select all metadata fields, right-click, choose "Copy"; then open the Properties dialog for the target group, select all metadata fields, choose "Remove" and then "Paste Fields" from the right-click menu. Read more...

Usage tips[edit]

You can open the Properties dialog for multiple tracks - by selecting a group of tracks in a playlist then choosing "Properties" from the context menu for an example. This lets you mass-edit tags of multiple tracks at once.

Various tag manipulation commands can be accessed by selecting one or more metadata fields then right-clicking the selection.

When editing tags of multiple tracks, double-clicking a field name - or choosing "Edit" from field's right-click menu - opens a dialog where you can see and edit each track's individual values of that field. You can also select multiple fields then use the "Edit" command to open a dialog where you can conveniently edit individual per-track values of each of those fields.

If your files have empty or incorrect tags but corrent artist/title/etc information is present in file or folder names, you can automatically transfer that information to tags using the "Automatically Fill Values..." command from the Tools menu. For an example, if your file naming scheme is "artist\album [date]\nn. title", you should set source to "File Names" and pattern to %artist%\%album% [%date%]\%tracknumber%. %title%". Read full article...

If you wish to go straight to the properties tab when opening the dialog - without additional clicking - you can hold ⇧ Shift while opening the dialog. This also applies to opening the dialog through keyboard shortcuts - if ⇧ Shift is a part of the keyboard combo used, the properties tab will be activated.

Advanced preferences[edit]

The Advanced preferences page.

The following options can be changed through the Advanced preferences page.

Always preload complete info up to N tracks
Specify how many track to pre-load metadata for.
Default: 100
Multiline fields
Specify which fields can contain line breaks.
Multivalue fields
Specify which fields can contain multiple values (which are separated with a ; semicolon).
Standard fields
Specify the "standard" fields visible in the "Properties" dialog in the "Name=Field" format, e.g. Artist Name=ARTIST. Each pairing must be separated by a semicolon.
Title display format

See also[edit]