Sync Files

This document describes version 6.x of the Sync File utilities.

This suite contains actions to convert files via Permute and XLD and to synchronize metadata between two copies of files.

If you are using the Permute functionality of these actions please note that version 3.6.4 or later is required. Version 3.6.4 enabled the ability of Yate to specify the destination folder. You should read the Working With Permute Presets topic to learn about matching presets based on audio properties.

Convert Files

Sync Files Utility - Overview

Sync Files Utility

Sync Files With Default Profile

Configuring Permute

Permute Preset Information Display

Permute Best Match

XLD Profile Information Display

Ignoring Files and Folders

Deleting Extra Folders

Content List, Requirements & History

Convert Files

This action is used to convert all selected files to a different file format using Permute or XLD. Note that all metadata is preserved. The action only processes selected files. The panel displayed if you have both Permute and XLD on your Mac, is as follows:

The Converter setting displays the name of the converter which will be used. If you have Permute and XLD on your Mac, there will be an associated menu which you can use to select your preference.

If you have Permute on your Mac the Permute preset and Permute best match settings will be displayed. If you have XLD on your Mac, the XLD preset setting will be displayed. The XLD profile setting will only bre displayed if you have defined profiles. If you have both applications on your Mac, only the settings appropriate to the selected Converter will be enabled.

When Permute displayed converter, Permute preset must contain the name of a preset. Active presets can be chosen from the menu button (down triangle) to the right of the field.

When Permute is the displayed converter, you can check the Best match checkbox will enable the ability to attempt to match the bit depth in an audio file to a preset. More information can be found in Permute Best Match.

When XLD is the displayed converter, you must specify a preset or profile name. When the XLD preset and XLD profile settings are enabled there will be a menu button (down triangle) to the right of each field which displays the available items. To enable specifying a profile, you must enable the XLD profile row via the row's checkbox.

Convert files in place places the new files in the same folder as each source file. When Convert files in place is not checked you must place a folder path into the Destination folder setting. You can display a panel to select the folder by double clicking in the Setting column of the Destination folder row or from same row's menu's Get Folder Path item.

This action attempts to preserve filenames and will not overwrite existing files unless you enable the Overwrite existing files setting.

By enabling the Delete source files setting, you can delete source files after a successful conversion. An attempt is first made to delete files by moving them to the trash. If the files cannot be moved to the trash they will be permanently deleted.

If you enable Close the converter when done, the converter application will automatically be closed.

The control to the right of the Permute preset information row, when appropriate, will display information on the available Permute presets. The format of the panel displayed is discussed in Permute Preset Information Display.

The control to the right of the XLD profile information button, row, when appropriate, will display a list of the available XLD profiles. The format of the panel displayed is discussed in XLD Profile Information Display.

Help for individual rows can be viewed by selecting a row and hitting the spacebar.

The Convert Files button will start the process to convert the files. When done a panel will appear displaying a summary and the location of the produced log file. There will be a View Log button to display the produced file in the Log Viewer. Note that the log file is overwritten after each conversion. The log file displays the steps that were performed for each audio file and will contain the final name of each produced file. A produced file's name might have a duplicate indicator appended if the source filename was already used.

After a conversion, deleted files will be removed from the main window and newly created files will be loaded and selected. With the exception of the encoder related fields, all metadata will have been copied from the source files to the produced files.

Back to top of page

Sync Files Utility - Overview

Many users have two or more activate copies of their audio files. Sometimes the copy is a one-to-one copy and sometimes the audio files are encoded differently.

These actions provide a means of syncing any changes to the metadata in the originals to a copy. The sync trigger is simple ... the two files have different modification dates. When a sync occurs, metadata is copied from the source file to the destination file.

Note that files or entire folders can be marked as never sync. See Ignoring Files and Folders for more information.

Note that the process does not mirror the data ... they only ensure that the destination contains everything at the source.

These actions only work if filenames and folder structures under the roots are exactly the same. For example if you are syncing /Users/Me/Music to /Volumes/Music/Copy, the following files are a match:

/Users/Me/Music/John Doe/His Best/song.mp3
/Volumes/Music/Copy/John Doe/His Best/song.???

The filename extension on the second file is described as ??? as how files get matched is controlled by the actions.

Two user facing actions are supplied:

Sync Files Utility

This is the main action which provides all the configurability.

Sync Files With Default Profile

The Sync Files Utility lets you create different profiles for different processes. This action runs the default profile without presenting any configuration options.

These actions let you optionally copy or convert the source files when the file at the destination is missing. When conversion is required, Permute is used. Permute's automation via Yate was jointly designed. If you do not have Permute on your Mac, the options to convert files will not be presented. These actions require Permute 3.6.4 or later.

Back to top of page

Sync Files Utility

This action is used to configure and edit profiles. It can also be used to execute a profile. Whenever this action is run, if there are no defined profiles you will be immediately prompted to create a profile. If at least one profile is defined you will be presented with the following panel:

You can manually enter profile names or select them from the popup menu displayed by the disclosure button. The default profile (used by the Sync Files With Default Profile) action, if any is identified by a ✓ on the menu.

The Help button will display this document.

The Run button will execute the profile specified in the text field.

The Manage ▾ button will displays a menu with the following functions:

Remove Profiles

A panel is displayed allowing you to select which profiles are to be removed.

Duplicate the Profile

The specified profile will be duplicated and automatically named. You can rename the profile via the Create / View button. Note that a duplicated profile will not modify the default profile.

Set the Default Profile

The specified profile will be made the default. Note this can also be done in the panel displayed by the the Create / View button.

Clear the Default Profile

No profile will be the default. Note this can also be done in the panel displayed by the the Create / View button.

The Create / View button is used to view, edit, rename and duplicate a profile. If the text field is empty a new profile will be created. If the text field is not empty and the specified name is not a defined profile, a profile of that name will be created. If the specified name is an existing profile, it will be edited.

When you want to close the action, use the Done button.

The Create/View Panel - Configuring Profiles

The Create/View Button will display the following panel:

The following section describes each row of the configuration panel:

Profile name

This field contains the name of the profile. If you change the name of a profile that already exists you will rename the profile when saving. The field cannot be empty.

Default profile

Use the popup menu to select Yes or No to establish if the displayed profile will be the default profile when saved.

Source folder

This root folder is the folder which will be passed to the Batch Processor. All files in or under the chosen folder will be processed. You select a folder by double clicking in the row's Setting column or from Get Folder Path menu item on the row's context menu. The value cannot be empty.

Destination folder

This root folder is the folder containing the files to be modified, if required. You select a folder by double clicking in the row's Setting column or from Get Folder Path menu item on the row's context menu. The value cannot be empty.

Source filename extensions

If you want to sync all encountered audio files leave the field empty. Alternately you can choose file types from the menu displayed by the row's popup menu. You can manually enter filename extensions if you wish. Items are separated by commas. Do not precede a filename extension by a period. ie. mp3 not .mp3

Destination filename extension

The row's popup menu displays the audio filename extensions supported by Yate. You only have to choose something from the popup menu if you are synching to different audio file types than in the source. If your libraries are copies nothing need be chosen. If you intend to use Permute or XLD to produce missing files, you must specify a filename extension on this panel. You can manually enter an extension if you wish. If you want some audio file types to be copied and some to be converted, this field must contain the file type of the files after converting.

Missing files

You must select an item from the popup menu to specify how you want to handle missing files. You can also manually enter the values. Depending on other settings, files can still be copied in certain circumstances even if Permute and XLD are chosen. The choices are:

Ignore

Ignore missing files.

Copy

Copy the source file to the destination.

Permute

This is only displayed if the Permute application is located on your Mac. When this item is selected, Permute may be used to produce missing destination files.

XLD

This is only displayed if the XLD application is located on your Mac. When this item is selected, XLD may be used to produce missing destination files.

Only convert audio types

This is only enabled if you selected Permute or XLD to produce missing files. If the field is empty, all missing files will be passed to the chosen converter, even if the source and destination file types are the same. If you want only certain file types to be converted and the others copied, select those audio types that you want converted. Note that MPEG-4 files are divided into AAC and ALAC. Similarly OGG files are divided into Opus and Vorbis.

Permute preset

If you specified Permute for Missing files you must specify which active Permute preset to use. The popup menu will display the name of all enabled Premute 3 audio presets. You can also manually enter the name. The row is only displayed if the Permute application is located on your Mac.

Permute best match

The Best match methodology enables the ability to attempt to match the bit depth in an audio file to a preset. More information can be found in Permute Best Match. You must select Yes or No to specify if you want to use the Best Match methodology. The row is only displayed if the Permute application is located on your Mac.

XLD preset
XLD profile

If you specified XLD for Missing files you must specify one of a preset or profile name. The popup menus will display the appropriate identified presets or profiles. You can also manually enter the names. The rows are only displayed if the XLD application is located on your Mac. The rows are only displayed if the XLD application is located on your Mac.

Copy non audio files

This setting specifies how to handle non audio files and folders in each source folder containing audio files. The choices are:

Never

Ignore non audio files and folders.

New Folder

If the destination folder corresponding to the source folder containing audio files currently being processed by the batch processor had to be created, all non audio folders and contained folders which do not have an audio file as a descendent, will be copied. Note that the copied folder completely overwrites a preexisting folder of the same name.

On Changes

Changes can be: creating the destination folder; copying a source file; converting a source file or synchronizing metadata to a file in the destination folder.

Always

An attempt is made to always copy the non audio files and folders.

Set folder icon

You can choose to set the icon of the destination folder. The choices are the same as with non audio files.

Search for extra folders

When folders are renamed on the source it is entirely possible that there may be redundant orphaned folders on the destination. When a sync run finishes you can optionally look for folders on the destination which do not exist on the source. If you enable this process and redundant folders are located you will be given the opportunity to selectively delete them.

Single folder

Typically you want to process all subfolders in the source folder. By using the Batch Processor, these actions can sync files in an entire folder tree. However there are times that you may only wish to process audio files directly in the source folder. ie. ignore subfolders. If you choose Yes for Single folder, only a single folder will be processed. If you enable single folder processing, Search for extra folders will be ignored.

When syncing ignore:

You can elect to ignore the following UDTIs: Apple App PID, Yate Album ID, Yate Track ID. When a UDTI is ignored, it is not overwritten when syncing. When copying a missing file, they are cleared after the copy. One possible use is you're maintaining two libraries for use with Apple's Music application. Each library requires its own PIDs.

The Help button is context sensitive and displays popup help for the selected row in the table. If you want to display this document, hold down the Option key while clicking on the Help button.

Clicking on the Run button will validate the values, save the profile and then start it.

Cancel will cancel any changes that you've made and will redisplay the main panel. It will not cancel the action.

The Remove Panel - Deleting Profiles

The Remove Button will display the following panel:

The table's context menu has Remove All and Remove None context menu items.

Back to top of page

Sync Files With Default Profile

If a default profile has been designed via the Sync Files Utility action and the profile information can be validated, the batch processor will be launched to run the profile.

Back to top of page

Configuring Permute

It is recommended that you make the following Permute 3 - Preferences - General settings:

• Disable Play a sound. Yate submits one file at a time. A sound after ever file is converted will become annoying.
• Enable Automatically clear the conversion list. This will remove each file that Yate pushes to Permute as soon as it's converted.

These actions can interact with any enabled Permute audio preset. Presets are enabled, created, duplicated and edited in Permute x - Preferences - Presets. Changes are not applied until Permute x - Preferences is closed.

Note that Permute's AAC preset does not refer to AAC in m4a files! More than likely these are the out of the box presets that you should be working with: AIFF, Apple Lossless, FLAC, M4A, MP3, Ogg (Audio) and WAV.

Back to top of page

Permute Preset Information Display

Each item in the displayed panel describes a Permute preset. The preset's settings are displayed. The first setting (and possible only setting) is the internal class name for the type of audio file being produced. If a C item is displayed, the value is Channels setting (0 for As Source). If an S item is displayed, the value is the Sample Rate setting (0 for Same as Source). If a B item is displayed, the value is the Sample Bits setting.

Back to top of page

Permute Best Match

Permute presets can mark the Channels and Sample Rate settings to match the source. However, there is no equivalent setting for the Sample Bits setting. When choosing a Permute preset you can also elect to enable Best match. When Best match is enabled the preset used is determined as follows:

• if an audio file's Bit Depth property matches the selected preset's Sample Bits setting, the selected preset is used.
• if a preset targeting the same audio type as in the chosen preset has the same Sample Bits as the Bit Depth property; and has a Channels setting of As Source; and has a Sample Rate settings of Same as Source; the preset will be used instead of the selected preset.
• the selected preset will be used.

Back to top of page

XLD Profile Information Display

This panel displays names of XLD profiles and their associated produced filename extension.

Back to top of page

Ignoring Files and Folders

When using the Sync Files or Sync Files With Default Profile actions you can elect to always ignore specific files or entire folders. A UDTI named NOSYNC or a custom field of the same name (case insensitive) is examined.

If any file in a folder has a NOSYNC value of 2, the entire folder is ignored. Any files which has a NOSYNC value of 1 are ignored. Any other value of NOSYNC is ignored.

If you wish to create a custom field, configure it as follows in Preferences - General - Custom Fields:

Back to top of page

Deleting Extra Files

If the Sync Files action is processing a profile where the Search for extra folders option is enabled, the source and destination folder trees will be compared. If extra folders, (folders in the destination but not in the source), are found they will be identified in a table.

You can select any folders that you want to delete. The context menu has items to select all or no folders for deletion.

Note that the selection of some folders may be redundant. For example if the following folders are displayed:

Album 1
Album 1/Disc 1
Album 1/Disc 2

Selecting Album 1 will delete its contained folders even if they are not selected.

Warning: This function deletes folders. It does not move them to the trash!

Back to top of page

Content List, Requirements & History

Actions:

Folder: Sync Files

Convert Files

Helper: Setup Common Help

Helper: Test for Converters

Helper: Read XLD Profile Names

Helper: Extract Permute Presets

Helper: Convert Engine

Helper: Process Best Match

Helper: Display XLD Profiles

Helper: Display Active Permute Presets

Helper: Extension for Permute Preset

Helper: Create/Edit Profile

Helper: Extract Profile Metadata

Helper: Validate Profile

Helper: Restore & Cancel

Helper: Run Batch Processor

Sync Files - Batch Processor

Helper: Walk Folder

Sync Files Utility

Sync Files With Default Profile

Rename Templates:

Variable 12

Requirements:

Yate v9.2.1

History:

Download