Hedge Helper

Automatically set up Hedge with the Hedge Helper menu bar app.
Hedge Helper is a small menu bar app (for MacOS) that enables you to automatically set up Hedge with a specific configuration (Workspaces).
Hedge Helper is currently in Beta and because it uses API calls it requires a Hedge Pro license. Email [email protected] if you are interested in a Hedge Pro license. All pro features can be found here.
Hedge Helper also installs a Finder Extension which allows you to use the contextual right-click menu in Finder to set a Source, Destination, or copy/paste with Hedge instead of Finder.
Hedge Helper and the Hedge Finder Extension

Getting Started

  1. 2.
    Open the app and click the Hedge Helper icon in the menu bar
  2. 3.
    Select Example Workspace.
  3. 4.
    Hedge will open, and a Source and Destination will get set.
Workspace files are stored in ~/Library/Preferences/Hedge/Workspaces/. You can quickly get to this location by selecting Manage Workspaces...
A Workspace is a JSON file that specifies how to set up Hedge. For each JSON file in the Workspaces folder, a separate menu item is created.

Workspace actions

A workspace file contains an array with one JSON object that can define the following actions:
"clearSourcesAndDestinations": true,
"setSources": ["/Users/hedge/Desktop"],
"setDestinations": ["/Users/hedge/Desktop"],
"setPreferencesToDefault": true,
"setCheckpointMode": "BACKUP",
"setPreferences": {"keyword": "value"},
"runBashCommands": ["say 'Hello'"],
"runAppleScript" : "/path/to/scriptfile.scpt"

Clear Sources and Destinations

When set to true, Hedge clears all Sources and Destinations.
"clearSourcesAndDestinations": true

Set Destinations

Sets one or multiple Destinations e.g ["/path/to/destinationOne","/path/to/destinationTwo"]
"setDestinations": ["/Volumes/X1"],

Set Sources

Sets one or multiple Sources as a collection e.g:["/path/to/source1","/path/to/source2"]
"setSources": ["/Volumes/Z1", "/Volumes/Z2"]

Restore Default Preferences

When set to true, Hedge's preferences are reset to their default setting (except for Connect connection and License preferences).
"setPreferencesToDefault": true,

Set Checkpoint Mode

Set Checkpoint to OFF, BACKUPor ARCHIVE.
"setCheckpointMode" : "OFF"

Set Preferences

Set any preference by using the dictionary below.
"setPreferences": {
"general_auto_source_recents": "0",
"general_auto_source_name_enabled": "1",
"general_auto_source_name_pattern": "UNTITLED;ARRI UDF;A*_*;B*_*",
"general_auto_recognize_destinations_enabled": "1",
"general_auto_eject_sources": "0",
"general_date_tomorrow_starts": "0",
"transfers_queue_mode": "0",
"transfers_checkpoint_enabled": "0",
"transfers_checkpoint_mode": "0",
"transfers_checkpoint_only_for_enabled": "0",
"transfers_checkpoint_only_for_pattern": "UNTITLED;ARRI UDF;A*_*;B*_*",
"transfers_logs_on_destination_enabled": "1",
"transfers_logs_on_destination_mhl_per_file_enabled": "0",
"transfers_extra_log_location": "",
"transfers_force_underscores": "0",
"connect_enable": "0",
"connect_reset_connect_on_quit": "0",
"integrations_foolcat_enable": "0",
"integrations_foolcat_match_destination": "",
"integrations_foolcat_report_location": "",
"integrations_foolcat_report_name": "{Source Name}",
"integrations_foolcat_report_description": "",
"integrations_frameio_enable": "0",
"integrations_parashoot_enable": "0",
"integrations_scratch_enable": "0",
"integrations_scratch_match_destination": "",
"integrations_scratch_match_extension": ".mov; .mp4",
"integrations_scratch_project": "",
"integrations_scratch_group": "{YYYY}-{MM}-{DD}",
"integrations_scratch_timeline": "{Source Name}",
"integrations_scratch_watchfolder": "/Library/Application Support/Assimilator/Watch",
"scripting_opt_in": "0",
"scripting_events_checkpoint_issue": "",
"scripting_events_disk_added": "",
"scripting_events_disk_busy": "",
"scripting_events_disk_idle": "",
"scripting_events_disk_removed": "",
"scripting_events_disks_idle": "",
"scripting_events_file_copy_completed": ""
Not all Preferences are built-in, we're adding them on a need-to-have basis. Missing one that is required in your workflow? Let us know.

Run bash commands

"runBashCommands": ["say 'Hello'"]

Run AppleScript

"runAppleScript" : "'/path/to/scriptfile.scpt'"
The example below loads a workspace and uses this script to set two Finder windows on the right side of the Hedge main window.


By default, Hedge Helper is set to automatically start at computer login.
Terminal command to disable:
defaults write nl.syncfactory.Hedge.Mac.Helper launchAtLogin 0
Terminal command to enable:
defaults write nl.syncfactory.Hedge.Mac.Helper launchAtLogin 1
Terminal command to check the current autostart setting:
defaults read nl.syncfactory.Hedge.Mac.Helper launchAtLogin

Startup workspace

Hedge Helper can launch a workspace automatically on startup: Terminal command to enable a startup workspace:
defaults write nl.syncfactory.Hedge.Mac.Helper launchWorkspaceAtStart "filename.json"
Terminal command to disable the startup workspace:
defaults delete nl.syncfactory.Hedge.Mac.Helper launchWorkspaceAtStart
Terminal command to check the current startup workspace:
defaults read nl.syncfactory.Hedge.Mac.Helper launchWorkspaceAtStart