How to open SupaView from anywhere

Look something up without leaving what you’re working on. SupaView is SupaSidebar’s small floating browser that opens on top of your current windows and leaves your browser tabs alone.

Ways to open SupaView

Skip the setup with SupaSidebar as your default browser

Raycast, Alfred and Spotlight open web searches in your default browser. Make SupaSidebar your default browser and those searches open in SupaView, like Little Arc did in Arc. You don’t need a Quicklink, a custom search or a shortcut. Follow the steps in Open links from other apps.

• Turn on SupaView in Labs first. Opening links from other apps in SupaView is a Labs feature and part of Pro. Without Pro, it’s free for 30 days from the day you turn it on.
• Every link from another app opens in SupaView, not only launcher searches. Hold Cmd Option while clicking a link to open it in your browser instead.
• Spotlight searches with Safari’s search engine. To change it, open Safari → Settings → Search.

To keep your current default browser, or to send only some searches to SupaView, use the setups below. Each one adds a peek keyword.

Open Command Panel results in SupaView

Select a result in the Command Panel and press the SupaView key. Saved links, recent links, live tabs, suggestions and the search row all open their page in SupaView. Results that aren’t web pages, like apps, files and commands, open the normal way.

One key opens SupaView and the other searches the web with your query.

To swap them, open Preferences → Command Panel → Shortcuts and set Cmd Return opens to SupaView or Web Search. Preferences → Shortcuts → Command Panel shows the key each one uses right now.

SupaView links

Any app that can open a link can send a page or a search to SupaView. The links start with supasidebar://peek, the name SupaView had before.

• Encode spaces as %20 or +. Raycast, Alfred and the Shortcuts app do this for you.
• Put q= or url= first. Everything after it counts as the search or the page link, so a pasted link keeps its own & parts.
• Only http and https pages open. Other links, like files or app links, are ignored.
• SupaSidebar doesn’t need to be running. The link starts it, and SupaView opens once it’s ready.

Set up Raycast

1. Open Raycast and run Create Quicklink.
2. Set Name to Peek.
3. Set Link to supasidebar://peek?q={argument name="Query"}.
4. Save the Quicklink.

To use it, type Peek in Raycast, press Tab, type your search and press Return.

To open a link you copied, make a second Quicklink with the link supasidebar://peek?url={clipboard}.

Set up Alfred

1. Open Alfred Preferences → Features → Web Search and click Add Custom Search.
2. Set Search URL to supasidebar://peek?q={query}.
3. Set Title to Peek {query} and Keyword to peek.
4. Click Save.

To use it, type peek, a space and your search in Alfred, then press Return.

Set up Spotlight

Spotlight can’t pass what you type into a link, so a small shortcut named Peek asks for your search and sends it. You make it once in the Shortcuts app.

1. Open Shortcuts and press Cmd N. Name the new shortcut Peek.
2. Add the Ask for Input action and set its prompt to Peek at.
3. Add URL Encode. It encodes Provided Input automatically.
4. Add URL. Type supasidebar://peek?q=, then insert the URL Encoded Text variable right after it.
5. Add Open URLs and close the editor.

To use it, press Cmd Space, type Peek and press Return. Type your search in the box and press Return.

Open SupaView from Terminal and scripts

open "supasidebar://peek?q=swift%20concurrency"

open "supasidebar://peek?url=https://developer.apple.com/documentation/swiftui"

Troubleshooting

Learn more

• SupaView - Staying signed in, links from other apps, security and window controls
• Command Panel - Search, scopes and every Command Panel key
• Keyboard shortcuts - The complete shortcut list