Documentation

Quick Start

DockDoor has full AppleScript support. Every command follows the same pattern:

tell application "DockDoor" to <command>

Try it right now in Terminal:

osascript -e 'tell application "DockDoor" to show switcher'

This opens the Window Switcher. You can also get a full list of commands:

osascript -e 'tell application "DockDoor" to get help'

Command Reference

Preview Commands

show preview also accepts optional parameters:

• at "x,y" — position the preview at specific coordinates
• dock frame "x,y,w,h" — position relative to a dock icon rect
• with delay true — use the configured hover delay

-- Show Safari preview at a specific position
tell application "DockDoor" to show preview "Safari" at "500,400"

-- Show by bundle ID with hover delay
tell application "DockDoor" to show preview "com.apple.Safari" by "bundle" with delay true

Window Actions

All window commands accept a window ID (number) or "active" for the frontmost window.

Position values: left, right, top, bottom, top-left, top-right, bottom-left, bottom-right.

-- Snap active window to the left half
tell application "DockDoor" to position window "active" to "left"

-- Close a specific window by ID
tell application "DockDoor" to close window "12345"

-- Center and focus a window
tell application "DockDoor"
    center window "67890"
    focus window "67890"
end tell

Querying Windows & Apps

These commands return JSON, making them easy to parse in scripts.

-- Get active window info
osascript -e 'tell application "DockDoor" to get active window'

-- List all Safari windows (returns JSON)
osascript -e 'tell application "DockDoor" to list windows "Safari"'

-- List all apps
osascript -e 'tell application "DockDoor" to list apps'

Third-Party Integration

Logitech Options+, BetterTouchTool & Other Macro Tools

If you use software that maps mouse buttons or macros to keyboard shortcuts, you may find that DockDoor's Window Switcher doesn't respond. This happens because macro software often simulates key presses differently than a physical keyboard — the modifier key (Option, Command) is pressed and released instantly rather than held down.

The fix is to use DockDoor's AppleScript command instead of simulating a keyboard shortcut:

tell application "DockDoor" to show switcher

This opens the Window Switcher directly, bypassing keyboard event detection entirely. It works with any automation tool that can run AppleScript.

Setup: Logitech Options+

1. Open Logi Options+ and select your mouse
2. Click the button you want to customize
3. Choose Smart Actions
4. Add an action → select AppleScript
5. Paste: tell application "DockDoor" to show switcher

Setup: BetterTouchTool

1. Open BetterTouchTool preferences
2. Select your input device and add a new trigger
3. Set the action to Run AppleScript (blocking)
4. Paste: tell application "DockDoor" to show switcher

Setup: Karabiner-Elements

In your karabiner.json complex modification, use shell_command:

{
    "type": "basic",
    "from": { "key_code": "tab", "modifiers": { "mandatory": ["option"] } },
    "to": [
        { "shell_command": "osascript -e 'tell application \"DockDoor\" to show switcher'" }
    ]
}

CLI Usage

Every AppleScript command can be run from Terminal with osascript -e:

# Open the window switcher
osascript -e 'tell application "DockDoor" to show switcher'

# Show preview for an app
osascript -e 'tell application "DockDoor" to show preview "Finder"'

# Snap active window to right half
osascript -e 'tell application "DockDoor" to position window "active" to "right"'

# Get all windows as JSON
osascript -e 'tell application "DockDoor" to list windows'

# Get built-in help
osascript -e 'tell application "DockDoor" to get help'