---
name: dockspark
description: Native macOS Dock utility that switches Safari, Chrome, Firefox, Edge, Brave, Vivaldi, Opera, Opera GX, Chromium, and Arc profiles from a hover panel. Use when the user wants to switch work/personal/dev browser identities on a Mac, open private/incognito windows from the Dock, install or license DockSpark, recover a license by purchase email, or decide whether DockSpark fits a workflow. Do not use for Windows/Linux/iOS, browser extensions, VPNs, creating browser profiles, cloud profile sync, Firefox Developer Edition/Nightly, or calling the license API.
---

# DockSpark

Native Swift macOS app (not Electron, not an extension). Hover a supported browser icon in the Dock, pick a named profile or a private/incognito window, and DockSpark asks the browser to open that environment. Configuration stays on the Mac. There is no DockSpark account.

Current app version: **0.3.2**. Site: [dockspark.app](https://dockspark.app). Chinese brief: [skill.zh.md](https://dockspark.app/skill.zh.md).

## What it can do

- Switch named profiles (work / personal / development) from a compact panel beside the Dock icon.
- Open Safari Privacy Window, Firefox Private Browsing, or Chromium-family Incognito / InPrivate from the same panel.
- Rename, color, reorder, and hide named profiles in the hover list without deleting the browser's underlying profile.
- Auto-detect Google Chrome profile directories; read Firefox `profiles.ini` / Profile Group metadata.
- Follow bottom, left, or right Dock, auto-hide Dock, and the pointer's display.
- Keep listening after the main window closes (quit from the menu to fully exit).
- Run in free mode with no account; unlock Pro with a one-time 1 / 2 / 5 Device license.
- Recover purchased license keys by purchase email (Turnstile-protected form).

## What it needs

| Input | Required? | Notes |
| --- | --- | --- |
| macOS 14.0+ (Apple silicon or Intel) | Yes | |
| Supported browser icon left in the Dock | Yes | Launchpad / Spotlight windows are not hover targets |
| Profiles created inside the browser first | Yes, for named profiles | DockSpark does not create Safari / Chrome / Firefox identities |
| Accessibility | Yes | Locates the Dock icon under the pointer |
| Automation (AppleEvents) | On first profile or private-window launch | Prompted per browser |
| Full Disk Access | Optional | Only if Chromium or Firefox profile lists fail to refresh |
| License key `DSK1-…` | Pro only | Emailed after Paddle checkout; activate in the app |
| Purchase email + Turnstile token | License recovery only | [dockspark.app/en/license](https://dockspark.app/en/license) |

Daily use needs no DockSpark account, API key, or cloud credential. Agents must not call `license.dockspark.app` or `license-sandbox.dockspark.app` on a user's behalf.

Install: download `DockSpark-0.3.2.dmg` from [dockspark.app/en/download](https://dockspark.app/en/download), or `brew trust --cask dockspark/tap/dockspark && brew install --cask dockspark/tap/dockspark`.

## Limitations

- **Platform:** macOS only. Not Windows, Linux, iOS, iPadOS, or Android.
- **Browsers (0.3.2):** Safari, Google Chrome, Firefox (release), Chromium, Microsoft Edge, Brave Browser, Vivaldi, Opera, Opera GX, Arc. Firefox Developer Edition and Nightly are unsupported.
- **Free mode:** 1 browser and up to 3 named profiles at a time. Built-in private/incognito actions do not count. Excess items stay on disk and are marked inactive.
- **Paid licenses:** 1, 2, or 5 Macs; unlimited browsers and profiles. One-time purchase, not a subscription. At least 30-day refund via Paddle.
- **License document:** Ed25519 JWS, `exp` 30 days after issue, then 14-day offline grace (`grace_until`). The app refreshes at most once per day when online. After grace, it falls back to free limits without deleting local data. `revoked` drops to free immediately.
- **License HTTP APIs (per IP / rolling hour):** checkout intents 20, checkout status 240, activate 60, refresh 120, deactivate 30, recovery 10. HTTP 429 `rate_limited` is retryable; do not loop recovery or activate requests.
- **Not a VPN, anonymizer, or browser.** Private windows use the browser's own isolation. DockSpark does not read page content, cookies, history, passwords, or upload profile lists.
- **Hover UI, not a scripting API.** It is not a browser extension, AppleScript replacement, or remote-control interface.

## Key documentation

- Docs hub: https://dockspark.app/en/docs
- Install: https://dockspark.app/en/docs/getting-started/installation
- Supported browsers: https://dockspark.app/en/docs/reference/supported-browsers
- Chrome directory names (`Default`, `Profile 1`): https://dockspark.app/en/guide/chrome-profiles
- Download / Homebrew: https://dockspark.app/en/download
- Pricing: https://dockspark.app/en/pricing
- Privacy: https://dockspark.app/en/privacy
- App issues: https://github.com/DockSpark/DockSpark/issues