Documentation
GitHub

Getting started

Permissions

Understand why DockSpark asks for Accessibility, Automation, and Full Disk Access, how to turn them off in System Settings, and how to reset them from Terminal.

Accessibility

Required for Dock hover

DockSpark uses the macOS Accessibility API to identify the Dock icon beneath your pointer and read its position. It cannot show the hover panel without this access.

Automation

Some browser actions need macOS Automation access. DockSpark asks only when you use an action that requires it, and macOS displays the consent prompt.

Full Disk Access

Reading Chromium or Firefox profiles can require Full Disk Access. When this is needed, DockSpark explains why before it opens System Settings. You can grant or decline the permission there.

You stay in control

These permissions are managed by macOS and can be reviewed or revoked at any time. Related features stop after you turn a permission off. You can still request it again from inside DockSpark.

Revoke permissions in System Settings

  1. Open System Settings. Choose Privacy & Security from the sidebar.
  2. Open the permission you want to remove. Choose Accessibility, Automation, or Full Disk Access.
  3. Turn DockSpark access off.
    • Accessibility and Full Disk Access: Turn the switch next to DockSpark off. To remove it from the list, select DockSpark and click the minus (−) button.
    • Automation: Expand DockSpark and uncheck each app it is allowed to control, such as Safari, Google Chrome, or Firefox.
  4. Follow any macOS prompt. If macOS asks you to reopen DockSpark, choose Quit DockSpark first. Closing the main window is not enough, because the app keeps running in the background.

After you revoke access, matching features stop. Without Accessibility, the hover panel cannot appear. Without Automation, opening a chosen profile or private window may fail. Without Full Disk Access, Chromium and Firefox profile lists may not refresh automatically, but you can still enter a Chromium directory such as Default or Profile 1 by hand.

Reset permissions and settings in Terminal

Dangerous operation

These commands delete the macOS permissions already granted to DockSpark and clear the app's local settings. DockSpark will not be able to provide the matching features until you grant access again: the hover panel needs Accessibility, opening a chosen profile or private window may need Automation, and reading Chromium or Firefox profile folders may need Full Disk Access. Saved profile names, colors, and order can also be lost. Use this only when you intend to reset. You can still request each permission again from inside DockSpark.

  1. Quit DockSpark first. Choose Quit DockSpark from the menu bar or Dock icon, or run the quit command below. Do not only close the main window.
  2. Open the Terminal app. Go to Applications → Utilities → Terminal. Use the built-in Terminal app, paste a command, and press Return.
  3. Run only the commands you need. Each command targets DockSpark's bundle identifier app.dockspark.DockSpark. Do not omit the bundle ID, or macOS may reset the same permission for other apps.

Quit DockSpark from Terminal:

Example
osascript -e 'tell application "DockSpark" to quit'

Remove Accessibility:

Example
/usr/bin/tccutil reset Accessibility app.dockspark.DockSpark

Remove Automation:

Example
/usr/bin/tccutil reset AppleEvents app.dockspark.DockSpark

Remove Full Disk Access:

Example
/usr/bin/tccutil reset SystemPolicyAllFiles app.dockspark.DockSpark

Clear DockSpark settings:

Example
defaults delete app.dockspark.DockSpark
rm -f ~/Library/Preferences/app.dockspark.DockSpark.plist
rm -rf ~/Library/Application\ Support/DockSpark
rm -rf ~/Library/Containers/app.dockspark.DockSpark

If defaults delete reports that the domain does not exist, you can ignore it—there were no settings to remove. Open DockSpark again when you are done. The app can request the permissions it still needs, and you can also turn the switches back on in System Settings. After Accessibility is restored, DockSpark can rebuild Dock hover observation.