Foobar2000:Properties: Difference between revisions

Latest revision as of 20:54, 6 December 2019

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

Metadata

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

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

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

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

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

Note: The "partial info" function was introduced in foobar2000 v1.3, and removed in foobar2000 v1.5.

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

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

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

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

@@ Line 1: / Line 1: @@
-= Properties Dialog =
+[[File:foobar2000 Properties dialog - Metadata tab.png|thumb|Metadata tab.]]
+The '''Properties''' dialog allows a user to view and modify the [[metadata]] of one or more audio files.
-[[Image:Foobar2000-Properties-HowToAccess.png|Properties dialog : how to access]]
+To open the Properties dialog, select one or more tracks (e.g. in a playlist), right-click, choose "Properties" from the context menu.
-[[Image:Foobar2000-Properties-Metadata.png|Properties dialog : Metadata tab]]
+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).
-[[Image:Foobar2000-Properties-Properties.png|Properties dialog : Properties tab]]
-== Usage ==
+==Tabs==
+===Metadata===
+All fields shown on the Metadata tab can be edited, either individually or by selecting more than one.
-To activate the Properties dialog, select one or more tracks (eg. in a playlist), right-click, choose "Properties" from the context menu.
+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.
-You can directly edit all metadata values (entries on the "Metadata" tab). Other information about the selected tracks - shown on the "Properties" tab - is read-only.
+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.
-To commit any edits you've made to file tags, press either "OK" button (to close the dialog) or "Apply" button (to save then continue viewing/editing).
+===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.
-[[Image:Foobar2000-properties-toolsmenu.png|frame]]
+; 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 [[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:
-* Selection : Same as right-click menu commands for currently selected metadata fields.
+; Clear ReplayGain information
-* Add New Field : Adds a new metadata field with any name that you specify.
+: Clears ReplayGain information on all tracks.
-* Paste Fields : See [[Foobar2000:Properties#Copy & Paste Functionality|Copy & Paste Functionality]] section below.
+; Scan track gain
-* 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.
+: Scans track gain on all tracks.
-* Automatically Fill Values : Allows you to automatically fill metadata values from file names / other metadata / other sources. [[Foobar2000:Properties/Automatically Fill Values|Read more...]]
+; Scan album gain (single album)
-* Reload Info : Reloads displayed information from your files. Any unsaved edits that you've made will be lost.
+: Scans track and album gain on the selected tracks; treats the tracks as one album.
-* Remove Tags
+; Skip scanning tracks/albums with info present
-** For file formats that support optional tags such as ID3 or APE, those optional tags are completey stripped.
+: Toggles whether tracks that already have ReplayGain information should be excluded from scans.
-** Any metadata or ReplayGain information is removed from the files.
-== Copy & Paste Functionality ==
+The ReplayGain fields shown are also editable.
-You can transfer metadata values between different fields (eg. 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.
+===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.]]
+Clicking the {{button|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: {{key press|Ctrl|N}}
+; Paste fields
+: See [[#Copy and paste functionality|copy and paste functionality]] section below.
+: Keyboard shortcut: {{key press|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. [[Foobar2000:Properties/Automatically Fill Values|Read more...]]
+; ReplayGain
+: Show a menu with the same ReplayGain commands as on the [[#ReplayGain|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|Advanced preferences]] page.
+==Partial info==
+[[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, 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.
+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 {{button|Tools}} button (see above) and select '''Load complete info'''.
+==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.
 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.
-== Usage Tips ==
+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==
 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 42: / 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.
-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 {{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==
+[[Image:foobar2000 Properties dialog - Advanced preferences.png|thumb|256px|The Advanced preferences page.]]
+The following options can be changed through the [[foobar2000:Preferences:Advanced|Advanced preferences page]].
-[[Image:Foobar2000-Properties-menu-commands.png|frame]]There are 3 different "Properties" context menu commands available:
+; Always preload complete info up to N tracks
-* "Properties" - opens the metadata tab by default, but opens the properties tab instead if you hold the shift key while activating it.
+: Specify how many track to pre-load metadata for.
-* "Properties (metadata tab)" - hidden by default; always opens the metadata tab; useful for custom keyboard shortcuts.
+: Default: {{code|100}}
-* "Properties (properties tab)" - hidden by default; always opens the properties tab; useful for custom keyboard shortcuts.
+; Multiline fields
+: Specify which fields can contain line breaks.
+; Multivalue fields
+: Specify which fields can contain multiple values (which are separated with a {{code|;}} semicolon).
+; Standard fields
+: Specify the "standard" fields visible in the "Properties" dialog in the "Name=Field" format, e.g. {{code|1=Artist Name=ARTIST}}. Each pairing must be separated by a semicolon.
+; Title display format
-== See Also ==
+== See also ==
+* [[foobar2000:Properties/Automatically Fill Values|Automatically Fill Values dialog]]
+* [[foobar2000:Components/Classic Properties Dialog (foo_properties_classic)|Classic Properties Dialog (foo_properties_classic)]] component
-[[Foobar2000:Properties/Automatically Fill Values|Automatically Fill Values dialog]]
+[[Category:foobar2000]]