Difference between revisions of "Foobar2000:Properties"

From Hydrogenaudio Knowledgebase
Jump to: navigation, search
(Added "Advanced preferences" section; minor page formatting changes.)
(Major rewrite of page, expanding on information already available, and consolidating the Foobar2000:Properties/Partial_Info page.)
Line 1: Line 1:
[[Image:Foobar2000-Properties-Metadata.png|thumb|256px|Metadata tab]]
+
[[Image:foobar2000 Properties dialog - Metadata tab.png|thumb|Metadata tab.]]
[[Image:Foobar2000-Properties-Properties.png|thumb|256px|Properties 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.
  
== Usage ==
+
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-HowToAccess.png|thumb|Accessing the Properties dialog]]
+
To activate the Properties dialog, select one or more tracks (eg. in a playlist), right-click, choose "Properties" from the context menu.
+
  
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.
+
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, press either "OK" button (to close the dialog) or "Apply" button (to save then continue viewing/editing).
+
== Metadata tab ==
 +
All fields shown on the Metadata tab can be edited, either individually or by selecting more than one.
  
=== Partial info ===
+
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.
{{main|foobar2000:Properties/Partial Info}}
+
In foobar2000 v1.3 and newer, in certain scenarios the Properties dialog will not show complete metadata of your files.
+
  
=== Tools menu ===
+
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.
[[Image:Foobar2000-properties-toolsmenu.png|thumb|The Tools menu]]
+
 
* Selection : Same as right-click menu commands for currently selected metadata fields.
+
== Details tab ==
* Add New Field : Adds a new metadata field with any name that you specify.
+
The Details tab is read-only, and is only used for showing metadata that has been generated by other means.
* Paste Fields : See [[#Copy and paste functionality|copy and paste functionality]] section below.
+
 
* 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.
+
; Location
* Automatically Fill Values : Allows you to automatically fill metadata values from file names / other metadata / other sources. [[Foobar2000:Properties/Automatically Fill Values|Read more...]]
+
: Information on the selected files, such as file path, file size and modify date.
* Reload Info : Reloads displayed information from your files. Any unsaved edits that you've made will be lost.
+
; General
* Remove Tags
+
: Information specific to the audio format/codec/tool that the file has been encoded with.
** For file formats that support optional tags such as ID3 or APE, those optional tags are completely stripped.
+
; ReplayGain
** Any metadata or ReplayGain information is removed from the files.
+
: 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
 +
: Displays playback information recorded by the [[Foobar2000:Components/Playback Statistics (foo_playcount)|Playback Statistics]] component.
 +
 
 +
== 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...]]
 +
; Load complete info
 +
: Fully loads all metadata fields when the "[[#Partial info|Partial info shown]]" warning is visible.
 +
; Reload info
 +
: Reloads displayed information from your files. Any unsaved edits that you've made will be lost.
 +
; 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.
 +
; Font...
 +
: Select the font, font style and font size for the Properties dialog.
 +
 
 +
== Partial info ==
 +
[[Image: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}}
 +
 
 +
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 ==
 
== Copy and paste functionality ==
Line 48: Line 83:
  
 
==Advanced preferences==
 
==Advanced preferences==
The following options can be changed through the '''Advanced''' preferences page.
+
[[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]].
  
 
; Always preload complete info up to N tracks
 
; Always preload complete info up to N tracks
Line 57: Line 93:
 
: Specify which fields can contain multiple values (which are separated with a {{code|;}} semicolon).
 
: Specify which fields can contain multiple values (which are separated with a {{code|;}} semicolon).
 
; Standard fields
 
; Standard fields
: Specify the "standard" fields visible in the "Properties" dialog in the "Name=Field" format, e.g. {{code|1=Artist Name=ARTIST}}.
+
: 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
 
; Title display format
  

Revision as of 17:54, 22 October 2018

Metadata tab.
Details 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).

Metadata tab

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 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.
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
Displays playback information recorded by the Playback Statistics component.

Tools menu

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...
Load complete info
Fully loads all metadata fields when the "Partial info shown" warning is visible.
Reload info
Reloads displayed information from your files. Any unsaved edits that you've made will be lost.
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.
Font...
Select the font, font style and font size for the Properties dialog.

Partial info

"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

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 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. The default is "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