DevBarDevBar
Download

Troubleshooting

Common issues and how to fix them.

Not finding an answer? Email [email protected] with your DevBar version (Help → About DevBar) and a description of the issue.
App won't startCan't connect to a platformNotifications not workingGlobal hotkey (⌥Space) not workingTouch ID not available for unlock

App won't start

  1. 1macOS Gatekeeper: If you see "DevBar cannot be opened because the developer cannot be verified", right-click DevBar.app and choose Open. Click Open in the dialog.
  2. 2Check macOS version: DevBar requires macOS 13 Ventura or later. Run About This Mac to verify.
  3. 3Re-download: The archive may be corrupted. Delete DevBar.app and download a fresh copy.
  4. 4Check Console.app: Open /Applications/Utilities/Console.app, filter by process name devbar, and look for crash logs.

Can't connect to a platform

  1. 1Verify the token: Re-generate the API token in the platform and paste a fresh one into DevBar Settings → Integrations.
  2. 2Check token scopes: Ensure the token has the minimum required scopes (see Platform Setup guide).
  3. 3Network access: DevBar makes outbound HTTPS calls to platform APIs. Check your firewall or VPN is not blocking them.
  4. 4Corporate proxy: If your network requires a proxy, set HTTPS_PROXY in Settings → Advanced → Environment Variables.
  5. 5Token expiry: Some platforms (e.g. GitHub fine-grained tokens) have expiry dates. Check if the token has expired.
Note: Open DevBar → View → Debug Console to see raw API error responses for each integration.

Notifications not working

  1. 1Grant notification permission: Open System Settings → Notifications → DevBar and ensure "Allow Notifications" is on.
  2. 2Check Do Not Disturb: macOS Focus modes suppress notifications. Check System Settings → Focus.
  3. 3Notification style: Set DevBar to Alerts (not Banners) so notifications persist until dismissed.
  4. 4In-app setting: Verify Settings → Notifications → the relevant platform is enabled inside DevBar.
  5. 5WebSocket connection: Notifications rely on a live WebSocket. Check Settings → Advanced → Connection Status shows Connected.

Global hotkey (⌥Space) not working

  1. 1Grant Accessibility permission: macOS requires Accessibility access for global hotkeys. Open System Settings → Privacy & Security → Accessibility and enable DevBar.
  2. 2Toggle off and on: After granting permission, disable and re-enable the global hotkey in Settings → General → Global Hotkey.
  3. 3Conflict with another app: Another application may have registered the same hotkey. Change DevBar's hotkey in Settings → General → Global Hotkey.
  4. 4Restart DevBar: Quit DevBar from the menu bar icon → Quit DevBar, then reopen it.
Note: If Accessibility permission keeps being reset after macOS updates, re-grant it each time and restart DevBar.

Touch ID not available for unlock

  1. 1Check hardware: Touch ID is only available on Macs with a Touch ID sensor or a Magic Keyboard with Touch ID.
  2. 2Enroll fingerprint: Ensure at least one fingerprint is enrolled in System Settings → Touch ID & Password.
  3. 3Supported macOS: Touch ID unlock requires macOS 13+. Verify your OS version.
  4. 4Enable in DevBar: Open Settings → Security and ensure "Use Touch ID to unlock" is toggled on.
  5. 5Restart DevBar: Quit and reopen DevBar after enabling Touch ID.