# Preferences

This statement is used to make changes to various preference settings or items. Unless otherwise mentioned, changes are automatically reverted as follows: When batch processing, the changes are reverted when the batch process stops. When not batch processing, the changes are reverted when the action started from the UI stops.

# Set Changes

Various functionality uses default preference sets. You can override the default values via specifying alternate sets. When the alternate set name is empty, the pre-action value will be reset. The set name can be chosen from a drop down menu or can be manually entered. The set name can contain any of the escape sequences described in Escape Sequences. At runtime, the set name must exist, be the empty string or be none (case insensitive). None is equivalent to removing the associated set. eg. setting the Natural Sort Exception Set to none, means there is no Natural Sort Exception Set.

The following sets can be overridden:

- Default Exception Set
- Case Exception Set
- Names Exception Set
- Natural Sort Exception Set
- Rename Exception Set
- Title Case Exception Set
- Weight Sort Exception Set
- Default Replacement Set
- Case Replacement Set
- Fold Characters Replacement Set
- Rename Replacement Set
- Sort Form Name Prefix Replacement Set
- Sort Form Ignore Suffix Replacement Set

# Individual Setting Changes

You can override various individual settings by specifying a temporary value. When the temporary value is empty, the application preferences value will be restored. The temporary value can contain any of the escape sequences described in Escape Sequences. The current settings which can be overridden are as follows:

Action Pending Window Font
  Set to 0 for a proportional font or non zero for a monospaced font.
Artwork Scale Only if Square
  This setting overrides the Preferences-Artwork scale only if approximately square option. A non zero integer value, enables the option. A value of zero disables the option.
Artwork Scale Size
  This setting overrides the Preferences-Artwork scale down to option. A value of zero implies do not scale. Other integer values represent the scale down to size.
Ask False Button Label
  Alternate text for the Ask statement's False button.
Ask True Button Label
  Alternate text for the Ask statement's True button.
Audio Free Space Padding
  Override the Preferences-Audio-Common free space padding value.
Audio Remove Free Space
  Override the Preferences-Audio-Common remove free space setting. A non zero numeric value enables the setting. Any other value disables it.
Auto Close Batch Processor Window
  This can be used to override the Preferences - Actions Automatically close the Batch Processor when done setting. An integer value of zero implies do not close while any other integer value implies close. Note that this preference change will be ignored unless Preferences - Actions Allow actions to override the auto close Batch Processor panel setting is enabled.
Batch Auto Save Files
  This can be used to override the batch processor's 'Auto Save Files' setting. A non zero numeric value enables the setting. Any other value disables it.
Batch Verbose Logging
  Set the value to 1 for verbose, or 0 for not. Note that this setting is ignored unless you are batch processing. Changing this setting will change the value of the Batch Verbose named variable.
Do not Treat 'mix' as a Roman Numeral
  Set the value to 1 for make sure mix is not treated as a Roman Numeral. Set it to 0 to allow it.
Log Raw Data Limit
  This override is used to set the data limit for the Log statement's raw data modes. A value of 0 will disable the display of binary data. A positive integer represents a raw data log with the specified amount as the limit. A negative integer represents a raw data log with no limit.
Lyrics Ignore Genre List
  Override the Preferences-Lyrics-Genre Ignore List. Note that genres in the list are delimited with newline (\n) characters.
Maximum Grouping-Work Name Compatibility
  This can be used to override the Preferences-Apple Apps-General setting of the same name. This is useful if you want to force the saving of an MP3 or AIFF files with a specific encoding for the Grouping and Work Name fields. A non zero numeric value enables the setting. Any other value disables it.
No Auto Tag Writes on Save
  This setting is intended to be used when you are attempting to remove all tag information from a file. This typically involves the use of a Clear statement followed by a Save statement. This setting only makes sense if you are clearing all tag information as it only disables those items which can write tag information not affected by a Clear. The temporary value is ignored except to test if it is empty. This item disables all preference settings which can cause the generation of tag information automatically or not associated with fields. The presense of this item with a non empty value currently disables the following settings:
  - Preferences-Apple Apps-General-Maximum Grouping-Work Name compatibility
  - Preferences-Audio-Common-Set Tagging Time whenever file is written
  - Preferences-Audio-MPEG-4-Apple App settings
    - Write empty Content Advisory
    - Process iTunMOVI for files with video
Notifications
  Enables or disables notifications. A non zero numeric value enables the setting. Any other value disables it.
Preserve Mod Date/Time when Saving Files
  Set to 0 for do not preserve or 1 for preserve.
Prefer PIDs When Linking
  A non zero numeric value enables the setting. Any other value disables it.
Rename Space Handling
  Set to 0 for No Changes, 1 for Remove Leading/Trailing or 2 for Remove Leading/Trailing and Compress.
Rename Substitution
  You can override the Preferences - Audio - Common - Rename Substitution setting. As the setting has a special interpretation when empty and this statement treats empty as restore the default value, enter a ? to imply the setting should be empty. Rename templates can directly override this setting but Move statements cannot.
Round Icon Corners
  A non zero numeric value enables the setting. Any other value disables it.
Unique Value Mode
  Set the value to 2 for GUS. Any other value is interpreted as UUID.
Video Aggressively Free Space
  Override the Preferences-Video aggressively free space value. A non zero numeric value enables the setting. Any other value disables it.
Video Fast Rewrites
  Override the Preferences-Video free space padding value.
Video Free Space Padding
  Override the Preferences-Video free space padding value. A non zero numeric value enables the setting. Any other value disables it. Note this will have no effect if Preferences-Video Override audio free space settings is not enabled. That setting can be overridden here via Video Override Audio Free Space Settings.
Video Override Audio Free Space Settings
  Modify the Preferences-Video Override audio free space settings. A non zero numeric value enables the setting. Any other value disables it.
Video Remove Free Space
  Override the Preferences-Video remove free space value. A non zero numeric value enables the setting. Any other value disables it. Note this will have no effect if Preferences-Video Override audio free space settings is not enabled. That setting can be overridden here via Video Override Audio Free Space Settings.
Write ID3 v2.3
  This setting is used to set writes of specific file types to use ID3 v2.3. The specified integer represents the sum of various Audio File Type property values. The appropriate values are:
  1 = mp3
  8 = aiff
  16 = dsf
  32 = wav
  64 = dff
  -1 = all ID3 based file types
Write ID3 v2.4
  This setting is used to set writes of specific file types to use ID3 v2.4. The value is constructed as in the Write ID3 v2.3 setting.
Extension
  This setting is reserved for extensibility which might be necessary prior to other items being added to this list.

# Clear Lists

You can choose to empty all preference lists (Artist, Composer, etc.) or any one single list. Warning: the clearing of a preference list is not undone when batch or action processing terminates. Note that you are clearing the lists as displayed in the Preferences-Lists section. Remember that any list can be associated with more than one field. Typically you would clear a list if you are going to use the Fill Lists statement to accumulate list contents.