Skip to content

hiddenSettings.md

Latest commit

 

History

History
148 lines (125 loc) · 5.8 KB

hiddenSettings.md

File metadata and controls

148 lines (125 loc) · 5.8 KB
Raw
permalink hiddenSettings.html
layout default
mainAnchor hiddenSettings
title Hidden Settings
subtitle Settings not yet available from the preferences panel

Some settings are not exposed in the Preferences panel and must be configured from the terminal using the defaults command.

General pattern

defaults write com.visualdiffer <key> <value>

Reset to default

defaults delete com.visualdiffer <key>

Changes take effect the next time the application is launched.

Settings

Click any row in the Example column to copy the full command to the clipboard.

Key Default Description Example
alwaysResolveSymlinks YES Resolve symbolic links when determining file paths. -bool false
colorsConfigPath — Path to a JSON file containing a custom color configuration. Recommended location: ~/Library/Application Scripts/com.visualdiffer "/path/to/vd-colors.json"
defaultEncoding UTF-8 Default character encoding for opening text files. The value is the CFStringEncoding integer identifier. -int 30
filesStatusBarShowMessageTimeout 3 Seconds a status bar message stays visible in the file diff view before the counters are restored. -int 5
foldersDifferenceNavigatorCenterInWindow YES Center the selected difference in the folder comparison window when navigating. -bool false
folderViewDateFormat ddMMyyHHmmss Date and time format used in the folder diff view. Pattern syntax: Unicode Technical Standard #35 HHmmss
showNotificationWhenWindowIsOnFront NO When NO, completion notifications are shown only when the app is in the background. When YES, notifications are always shown. -bool true
showRecentDocumentsList NO Show the Recent Documents popup menu on the main window. -bool true

How to Use a Custom Color Scheme

Installation

Use the Color Scheme Editor to create a custom color scheme, then download the JSON file. For example, save the file as ~/Downloads/my-scheme.json.

Open Terminal and run the following commands.

Copy the file to a directory that the VisualDiffer sandbox can access.

cp ~/Downloads/my-scheme.json ~/Library/Application\ Scripts/com.visualdiffer

Set the colorsConfigPath property to the full path of the copied file.

defaults write com.visualdiffer colorsConfigPath ~/Library/Application\ Scripts/com.visualdiffer/my-scheme.json

Changes to the color scheme take effect only after you restart VisualDiffer.

Custom color schemes do not respond to changes between Light and Dark appearances. If you switch the appearance, the custom color scheme remains active.

Restore the Default Setting

To stop using the custom color scheme, run the following command:

defaults delete com.visualdiffer colorsConfigPath