Skip to Content
FeaturesBrowser Selection

Browser Selection

Choose which browser opens your saved links - assign specific browsers per link, use your active browser dynamically, or pick on demand for ultimate flexibility.

Quick Start - Three Ways to Select a Browser

1. Right‑Click → Open With

  • Right‑click on any link.
  • Choose “Open With…” from the context menu.
  • Pick any installed browser.
  • Hold Option (⌥) and click a link.
  • Supa Sidebar opens a browser selection popup.
  • Choose the browser you want.

3. Option + Enter from Command Panel

  • Open the Command Panel.
  • Select a link or command that involves opening a webpage.
  • Press Option + Enter (⌥ + Return).
  • Choose the browser from the popup.

Note: The browser selection popup only appears when using shortcuts or modifier keys (Option‑Click, Option‑Enter). Your last used browser may be remembered depending on user settings. All three methods work for links, tabs, and certain URL‑related commands.

Default behavior: If user does nothing, a link opens in its assigned browser. If no assignment exists, it opens in the system default browser.

Browser Picker

Available Browsers

The browser picker shows all installed supported browsers:

Installed Browsers:

  • Shown at top of picker
  • Includes icon and name
  • Click or Return to select

Not Installed:

  • Grayed out or not shown
  • Install browser to enable

Keyboard Shortcuts

ShortcutAction
⌥ClickShow browser picker for clicked link
⌥ReturnShow browser picker for selected link
↑ / ↓Navigate browser picker
ReturnSelect browser in picker
EscCancel browser picker

See Global Shortcuts for complete reference.

Troubleshooting

Browser Not in Picker

Issue: Expected browser doesn’t appear in picker

Solutions:

  1. Ensure browser is installed in Applications folder
  2. Verify browser is supported (see Browser Support)
  3. Restart SupaSidebar
  4. Check browser app name matches expected name

Wrong Browser Opens

Issue: Link opens in unexpected browser

Solutions:

  1. Check link’s browser assignment (right-click → check which browser is selected)
  2. Verify Link Opening Behavior in Preferences → General
  3. If using “Active Browser” mode, ensure correct browser is frontmost
  4. Right-click link → Set Browser → Choose correct browser

Browser Picker Doesn’t Appear

Issue: ⌥Click or ⌥Return doesn’t show browser picker

Solutions:

  1. Ensure Option key is held down while clicking/pressing Return
  2. Check keyboard is working (test Option key in other apps)
  3. Verify link is selected (for keyboard method)
  4. Try mouse method if keyboard doesn’t work
  5. Restart SupaSidebar

Window Adjustment Not Working

Issue: Browser window doesn’t resize with sidebar

Solutions:

  1. Check Preferences → General → Browser window adjustment is not “None”
  2. Verify browser supports window adjustment (see supported browsers above)
  3. Firefox and Arc don’t support automatic adjustment
  4. Try manual window resizing if automatic doesn’t work

Auto-Visibility Not Triggering

Issue: Sidebar doesn’t appear when switching to browser

Solutions:

  1. Check Preferences → General → “Show sidebar when browser is active” is enabled
  2. Ensure browser has Automation permissions
  3. Try clicking browser window to make it frontmost
  4. Restart SupaSidebar

Browser Assignment Not Saving

Issue: Browser selection doesn’t persist

Solutions:

  1. Ensure you’re using “Set Browser” (right-click), not one-time selection (⌥Click)
  2. Check you’re not in “Always ask” mode (Preferences → General)
  3. Verify link saves properly (delete and re-save if needed)
  4. Check CloudKit sync status if using multiple devices
Last updated on
SetupCommand Panel