Introduction
Description
DirEqual main window is divided into 4 sections: Toolbar, path panel, results view (list) and status bar.
(2) Compared folder paths. To select folders to compare:
      - click the browse button on the left side and select folders,
      - drag and drop folders to compare. You can drag one or two folders at a time,
      - manually enter folder paths,
      - long press the browse button and select from last chosen folders:
DirEqual is an advanced directory compare utility for Mac. It allows detecting the tiniest changes between folders and display the result with a clear and intuitive way. The differences are highlighted using colors and icons indicating the difference type (size, date or item content).
(5) Comparison status displays progress bar during compare process. After the compare has finished a short info of the compare result is shown.

(6) Comparison result view displays all files and folders inside the compared folders. You can expand subfolders on the left or right side to examine files inside. To expand a folder and all its child subfolders, select the parent folder and hold down the Option key while clicking the expand button.
To collapse a folder and all its child subfolders, select the parent folder and hold down the Option key while clicking the collapse button.
Attributes that are different are displayed in red color. If a file name is displayed in red color, that means the files' content differ.
Right click on a file displays context menu for it. DirEqual recognizes clicking on a left and right file and displays the proper menu options for the left or right file. Clicking on the middle column (> = <) displays the menu for both left and right file.
Color backgrounds - draws color backgrounds under compared items.
Show column lines - displays vertical lines separating columns in the result view.
Alternating row colors. The rows in the result view will be displayed with an alternating background color.
Display time. The date column will contain the file modification time.

Compare subfolders - compare all subfolders.
Ignore dates - this option allows you to exclude dates from comparison.
Include hidden items - unselect to skip all hidden files and subfolders.
Include empty folders - show/hide empty folders.

Include aliases - aliases and symbolic links will be included in the result list.
Resolve aliases - aliases will be compared not by the contents but by resolving original files. If both compared aliases point to the same item or point to items which are on the same path in left and right folder, the aliases will be considered equal. For example:
left folder: /Users/test
right folder: /Volumes/backup
left alias points to /Users/test/applications/Mail.app
right alias points to: /Volumes/backup/applications/Mail.app
The aliases will be considered equal (even if /Users/test/applications/Mail.app and /Volumes/backup/applications/Mail.app are not equal).
If "resolve aliases" is off, aliases are compared as other files - by size, date and their content if "compare contents" is on.

Compare resource forks - if compared files contain resource forks, the forks will be also compared. This option works only if "Compare file contents" is enabled and if the both compared files have the same content.
Compare file tags - Works the same as "Compare resource forks" but for file tags instead of resource forks.

Calculate folders size - calculate and display compared subfolder sizes
Compare only - set a filter for compared items. Only files/folders which names matches the filter will be compared. Enter ".mp3" (without the quotation marks) to compare only mp3 files.
(7) Path navigator (not shown on the screenshot) displays the path of a selected file or folder. The path for left file is displayed if you select the file on the left side. The path for right file is displayed if you select the file on the right side.

(8) Blue and red backgrounds indicate actions to be performed. To set an action, click the dot in the middle column (> = <). You can set up three types of actions: Copy, Copy As, and Delete. When you click the dot in the middle column without pressing any additional key, the "Copy" action will be set. The action is represented by an arrow (red color if overwrite will cause overwrite). To set "Copy As" action hold down the Shift key while clicking the dot. To set the "Delete" action, hold down the Option key while clicking the dot. To select only items that differ, press the Command key and click the items' parent folder.
After clicking the dot icon on selected elements, the action will be applied to all selected elements:
The number displayed in the blue circle badge shows number of actions to perform. Click "Execute" button to display the confirmation window and perform the actions:
Move items to Trash... - all deleted or overwritten items will be moved to the Trash first. This will allow you to revert actions if you made a mistake when selecting actions.
Compare Files
Compare Folders
(1) The toolbar contains main controls and buttons. From the left side:
- Excluded folder. Allows to define folders which will be skipped when comparing the left and right folders.
- Compare file content. If unselected only date and size is used to decide if the two files are the same. If you select this option, content of every file is read and compared with the opposite file. This gives you 100% guarantee that compared files are equal or differ. Comparing files content slows down the comparison process.
- Compare options.
- Status bar.
- Start button. Press to initiate the comparision. The button will change to Stop button which allows to abort the comparision.
- Mirror Sync button. Click to synchronize the two folders. Wikipedia.
- Execute button. When Copy/delete actions have been set, this button executes all the actions. To clear all the actions set previously, hold down the Option key while clicking the Execute button.
- Info Panels button. Click to open / close panels with detailed information on selected items.
-The segment switch which allows to choose between folder and file comparator.
To compare files, click the right button on the segment switch (2). You can also drag and drop two files to the header of the window. That will switch into file compare mode. Alternatively you can right click on a file in the folder compare result list and select "Compare Items" from the context menu.
Compare files allows to compare text or binary (non-text) files. The result of the comparison is displayed in the form of a listing with marked differences.
Red background - lines of text are different.
Blue background - a line of text exists only in one file.
White background - lines of text are the same.

Files type allows you to select a type of compared files (text or binary).
Font size allows to adjust font of the listing.
Comparison of text files.
Comparison of binary files.
Compare options:
Actions
The actions can be also selected from the right-click context menu. Right click on a dot icon to display the menu:
      To exchange left and right folders, click the left/right arrow button in the middle.
      The control panel also displays basic statistics of the compared folders (size in bytes, number of files, number of folders). The statistics are displayed after compare process has finished.

(3) Comparision result filter:
     
, = show files detected as identical,
     
show files which differ,
     
, - show files which only exist in left/fight folder.
Files Access Problems
If you encounter that some files or folders are not accessible by DirEqual (the size is listed as zero B), try the following:

Reset DirEqual permissions:
1. Open "Terminal" (can be found by Spotlight)
2. Enter the following command (you can copy and paste it):
tccutil reset All com.naarak.DirEqual
and press Enter key.
3. Log out and log in again.
Add Full Disk Access:
1. Open "System Preferences"
2. Click "Security & Privacy"
3. Click "Privacy" tab
4. Select "Full Disk Access" on the left list
5. Unlock the panell by pressing the "lock" button
6. Click "plus" button and add DirEqual app from the Applications folder.
The meaning of the symbols in DirEqual
Action errors
If errors occur while performing an action (when copying or moving files and folders), they are marked with appropriate icons in the "Action" column. Hover over the error icon to display the error message as a tooltip. Click the icon to open the target item folder:
Synchronization
Mirror sync is a one-way sync in which newly added and modified files in the source directory will be synced to the target directory but no files are copied back to the source location. After the sync is complete, the files in the target directory will be exactly the same as the files in the source directory.

Files in the target directory that are inconsistent with those in the source directory will be deleted or overwritten.

Overview - Runs on the current comparison result. Selects items to copy (and delete, if enabled). To synchronize, click the "Execute" button.
Rescan - Recompares folders and selects items to copy (and delete).
User Manual
Written by and Copyright © 2022 Naarak-Studio
EnglishFrenchGermanItalianPortugueseRussianSpanish
Copyright © 2022 by Naarak-Studio   •   All Rights reserved   •   eMail: contact@naarakstudio.com