DockLock Pro URL Scheme

Jun 30, 2025

DockLock Pro URL Scheme & CLI Reference

DockLock Pro exposes a custom URL scheme (DockLockPro://) that lets you control every core feature—from locking/unlocking the Dock to moving it between screens—via URLs you can call from a browser, another app, or the command line. Installation via the App Store handles URL scheme registration automatically; no user action is required.

1. URL Format

DockLockPro://<command>[?<param1>=<value1>&<param2>=<value2>]
  • Scheme: DockLockPro
  • Host: the command name (see below)
  • Query (optional): parameters name, x, y as required

Tip: Coordinates use a top-left origin of the main display (x grows rightwards, y grows downwards).

2. Supported Commands

URL Host Description Query parameters
enableDockLock Turn on DockLock engine none
disableDockLock Turn off DockLock engine none
enableDockFollowsMouse Enable “Dock follows mouse” mode none
disableDockFollowsMouse Disable “Dock follows mouse” mode none
quit Quit the DockLock Pro application none
moveDockUp Move the Dock one screen up none
moveDockDown Move the Dock one screen down none
moveDockLeft Move the Dock one screen left none
moveDockRight Move the Dock one screen right none
moveToDisplay Move the Dock to a specific display name=… or x=…&y=…
enableDockLockOnDisplay Enable DockLock only on the given display name=… or x=…&y=…
disableDockLockOnDisplay Disable DockLock only on the given display name=… or x=…&y=…

Warning:

  • If two displays share the same name, prefer the x/y coordinate variant.
  • Coordinates outside any display are ignored.

3. Examples

3.1 Simple on/off

# Enable DockLock
open "DockLockPro://enableDockLock"

# Disable Dock follows-mouse
open "DockLockPro://disableDockFollowsMouse"

3.2 Moving the Dock one screen over

# Move dock to the monitor above
open "DockLockPro://moveDockUp"

3.3 Move to a named display

# Move to display named "Studio"
open "DockLockPro://moveToDisplay?name=Studio"

3.4 Move to display by coordinate

# Move to whichever display contains point (1920, 200)
open "DockLockPro://moveToDisplay?x=1920&y=200"

3.5 Lock/Unlock on a specific screen

# Enable DockLock only on "Studio"
open "DockLockPro://enableDockLockOnDisplay?name=Studio"

# Disable DockLock on display at (0,0)
open "DockLockPro://disableDockLockOnDisplay?x=0&y=0"

3.6 Quit the app

open "DockLockPro://quit"

4. Invoking from the Command Line

macOS’s open command will dispatch the URL to your running app (or launch it if needed):

open "DockLockPro://disableDockLock"

You can wrap these in shell scripts, Automator workflows, or any other launcher.

5. Notes & Best Practices

  • URL-encode any spaces or special characters in display names (e.g. My%20Monitor).
  • Coordinate origin (0,0) is the top-left of your main display; x grows rightward, y downward.
  • Mix & match: you can combine URL calls with Apple Shortcuts or other automation tools for maximum flexibility.
  • Shortcuts integration: For detailed instructions on Apple Shortcuts automation, see DockLock Pro Shortcuts.
  • Error handling: URLs with unknown hosts or invalid/missing parameters are safely ignored.

🚀 Ready to script your Dock? Combine this URL scheme with shell aliases, Automator Quick Actions, or your favorite launcher for instant control!

Homepage | FAQ | Support