DockLock Plus Shortcuts Integration
This guide explains how to use macOS Shortcuts to interact with DockLock Plus via custom App Intents, and how to run those shortcuts from scripts when needed.
1. Prerequisites
- macOS 13.0 or later
- DockLock Plus must be installed and launched at least once.
- Enable Accessibility for DockLock Plus in System Settings › Privacy & Security › Accessibility.
2. Overview of Available Intents
DockLock Plus provides the following App Intents for Shortcuts and scripting:
| Title | Description | Parameters | Returns |
|---|---|---|---|
| Enable DockLock Plus | Enables the DockLock Plus engine, locking the Dock to your selected display. | — | Void |
| Disable DockLock Plus | Disables the DockLock Plus engine, restoring default Dock behavior. | — | Void |
| Enable Dock Follows Mouse | Enables automatic Dock movement following the mouse. | — | Void |
| Disable Dock Follows Mouse | Disables automatic Dock movement following the mouse. | — | Void |
| Is Dock Follows Mouse Enabled? | Returns true if Dock Follows Mouse feature is enabled. | — | Bool |
| Is DockLock Plus Enabled? | Returns true if the DockLock Plus engine is enabled. | — | Bool |
| Launch DockLock Plus | Starts the DockLock Plus app if not running. | — | Void |
| Quit DockLock Plus | Quits the DockLock Plus app. | — | Void |
| Move Dock to Display | Moves the Dock to a specific display by name. | Display Name | Bool |
| Get Current Dock Display | Returns the name of the display where the Dock is currently located. | — | String |
| Move Dock to Adjacent Display | Moves the Dock to the display adjacent in the given direction. | Direction (left/right/up/down) | Bool |
| Allow Dock on Display | Allows Dock to appear on a specific display by name. | Display Name | Bool |
| Disallow Dock on Display | Prevents Dock from appearing on a specific display by name. | Display Name | Bool |
| Enable Dock Follows Active Window | Enables Dock following the currently active window. | — | Void |
| Disable Dock Follows Active Window | Disables Dock following the active window. | — | Void |
| Is Dock Follows Active Window Enabled? | Returns true if Dock Follows Active Window feature is enabled. | — | Bool |
If you have multiple displays that share the same name, prefer Move Dock to Adjacent Display (left/right/up/down) instead of selecting a display by name.
3. Installing Intents in Shortcuts
- Open the Shortcuts app.
- Click "+" to create a new shortcut.
- In the Actions sidebar, search for DockLock Plus.
- Expand the DockLock Plus section to view the available App Intents.
- Drag the desired Intent into your workflow.
- If the Intent has parameters (e.g.
Move Dock to Display,Move Dock to Adjacent Display), fill in the fields. - Name and save your shortcut.
4. Example Shortcuts
Here are a few representative shortcut workflows to demonstrate how to combine DockLock Plus intents:
-
Lock and Unlock Dock
- Enable: Drag Enable DockLock Plus intent into your shortcut to lock the Dock.
- Disable: Drag Disable DockLock Plus intent to restore default behavior.
-
Toggle Dock Follows Mouse
- Drag Enable Dock Follows Mouse and Disable Dock Follows Mouse intents into a single shortcut to quickly switch the feature on or off.
-
Move Dock by Display Name
- Add Move Dock to Display intent.
- Set Display Name to your target monitor (e.g. “External Monitor”).
-
Move Dock to Adjacent Screen
- Add Move Dock to Adjacent Display intent.
- Choose Direction (Left/Right/Up/Down) to shift the Dock one screen over.
-
Enable/Disable DockLock Plus on Specific Displays
- Enable by Name: Drag the Allow Dock on Display intent, set Display Name.
- Disable by Name: Drag the Disallow Dock on Display intent, set Display Name.
Feel free to combine these steps in any order to create custom workflows that suit your needs.
Menu Bar & Tray Integration
You can pin any shortcut you create to the menu bar (or system tray) for one‑click access:
- Open the Shortcuts app and locate your custom DockLock Plus shortcut.
- Right‑click (or Control‑click) the shortcut and choose Pin in Menu Bar.
- The shortcut’s icon will appear in the menu bar—click it anytime to run your DockLock Plus action directly.
This allows you to trigger DockLock Plus shortcuts without opening the Shortcuts app.
6. Terminal Usage
The built‑in shortcuts CLI lets you run your DockLock shortcuts from scripts:
# List your shortcuts
shortcuts list
# Run "Lock My Dock"
shortcuts run "Lock My Dock"
Integrate into shell scripts, launchd, or other automation tools.
Note: Before assigning a hotkey, make sure you have already created the shortcut using the steps in Installing Intents in Shortcuts.
7. Triggering Shortcuts via Hotkey
- In the Shortcuts app, open the shortcut you want to assign.
- Click the “(i)” icon in the top right corner to open Details.
- Under Run with, click the key field and press your desired hotkey.
- Uncheck Provide Output.
- Set Receive input from to None.
- Close the Details pane.
Note: Choose a unique hotkey combination. If another app uses the same hotkey and is active, it will take priority and your shortcut will not run.
8. Siri Integration
You can also trigger any of your DockLock Plus shortcuts using Siri. Just say:
“Hey Siri, Move Dock Left”
For the first time ever, DockLock Plus lets you move the Dock using Siri-an action that was never possible before on macOS.
Note: Before using Siri to trigger a shortcut, ensure you have already created the shortcut using the steps in Installing Intents in Shortcuts.
9. Troubleshooting
- Permissions: Verify DockLock Plus is granted Accessibility in System Settings.
- Intent Availability: Restart the Shortcuts app after installing/updating DockLock Plus.
- Parameter Validation: Confirm display names match your setup.
- Logs: Enable debug logging in DockLock Plus Preferences to diagnose failures.