Keyboard Shortcuts
SupaSidebar is designed for keyboard-first productivity. Master these shortcuts to navigate faster and work more efficiently.
Global Shortcuts
These shortcuts work anywhere on your Mac, even when SupaSidebar is not visible.
| Shortcut | Action | Description |
|---|---|---|
| ⌘⇧Space | Toggle Sidebar | Show or hide the main sidebar |
| ⌘⌃F | Focus Sidebar | Bring sidebar into focus without toggling |
| ⌘⌃K | Open Command Panel | Quick access to search and commands |
| ⌘⌃P | Pin Sidebar | Pin sidebar to follow you across all desktop spaces |
| ⌘⌃L | Toggle Sidebar Side | Switch sidebar between left and right sides |
| ⌘⌃S | Smart Save | Save current page from browser OR add files from Finder |
| ⌘⌃C | Smart Copy | Copy URL from browsers OR file paths from Finder |
| ⌘⌥A | Add Current Folder | Add current Finder folder to sidebar (ignores file selection) |
| Custom | Create New Link (Global) | Open link creation sheet from anywhere (no default - set in preferences) |
Space Navigation
Navigate between desktop spaces using keyboard shortcuts. Enable in Preferences → Spaces.
| Shortcut | Action | Description |
|---|---|---|
| ⌘⌃← | Previous Space | Navigate to previous desktop space (cyclic) |
| ⌘⌃→ | Next Space | Navigate to next desktop space (cyclic) |
| ⌘⌃1 - ⌘⌃9 | Jump to Space 1-9 | Direct navigation to specific spaces (optional, enable in preferences) |
Pinned Items
Quickly access your pinned items with number shortcuts. Enable in Preferences → General.
| Shortcut | Action | Description |
|---|---|---|
| ⌘⌥1 - ⌘⌥9 | Open Pinned Item 1-9 | Instantly open the corresponding pinned item |
In-Sidebar Navigation
These shortcuts work when the sidebar is visible and focused.
| Shortcut | Action | Description |
|---|---|---|
| ↑ / ↓ | Navigate Up/Down | Move selection through links and folders |
| ⇧↑ / ⇧↓ | Extend Selection | Select multiple items |
| ← | Collapse/Go Up | Collapse expanded folder OR move to parent folder |
| → | Expand/Enter | Expand folder OR enter folder if already expanded |
| Return | Open Link | Open the selected link |
| ⌥Return | Browser Selection | Show browser selection popover for selected link |
| Space | Rename | Start renaming the selected item |
| ⌘R | Rename | Alternative shortcut to rename selected item |
| Esc | Close/Cancel | Cancel editing OR clear selection OR close sidebar |
| ⌘Delete | Delete | Delete the selected link(s) |
| ⌘C | Copy URL | Copy the selected link’s URL to clipboard |
| ⌘V | Paste URL | Paste and create new link from clipboard URL |
| ⌘P | Pin/Unpin | Toggle pin status of the selected link |
| ⌘N | New Link | Open the link creation sheet |
| ⌘Q | Quit | Quit SupaSidebar application |
Command Panel Shortcuts
These shortcuts work when the Command Panel (⌘⌃K) is open.
| Shortcut | Action | Description |
|---|---|---|
| ↑ / ↓ | Navigate Results | Move through search results |
| Return | Open Result | Open the selected search result |
| Esc | Close Panel | Close the command panel |
| ⌘V | Paste & Search | Paste URL and create new link |
Click Modifiers
Hold these keys while clicking for quick actions.
| Modifier | Action | Description |
|---|---|---|
| ⌘ Click | Open in Default | Open link in your default browser |
| ⌥ Click | Browser Selection | Show browser picker to choose which browser to use |
Tips for Productivity
Smart Save & Copy Context Awareness
The ⌘⌃S (Smart Save) and ⌘⌃C (Smart Copy) shortcuts are context-aware:
- In a Browser: Save/copy the current page URL
- In Finder: Save/copy selected files or folders
- Anywhere Else: Defaults to browser behavior
Learn more: Smart Shortcuts → - Complete guide to context-aware shortcuts
Customizing Shortcuts
You can customize most global shortcuts in Preferences → Shortcuts:
- Open SupaSidebar preferences
- Navigate to the Shortcuts tab
- Click on any shortcut to record a new key combination
- Press the desired key combination
- Changes are saved automatically
Disabling Optional Shortcuts
Some shortcut groups can be toggled on/off:
- Space Navigation Number Shortcuts (⌘⌃1-9): Enable/disable in Preferences → Spaces
- Pinned Item Shortcuts (⌘⌥1-9): Enable/disable in Preferences → General
This prevents conflicts with other apps that may use the same shortcuts.
Keyboard-First Workflow Example
Here’s a typical keyboard-only workflow:
- ⌘⌃K - Open command panel
- Type to search for a link
- ↓ - Navigate to desired result
- Return - Open the link
- Browse and find interesting page
- ⌘⌃S - Save current page to SupaSidebar
- ⌘⇧Space - Close sidebar
- ⌘⌥1 - Later, instantly open your first pinned item
All without touching the mouse! 🚀
Shortcut conflicts? If any SupaSidebar shortcuts conflict with other apps, you can customize them in Preferences → Shortcuts.