Getting Started

1. Install Which Browser

1. Download the latest installer for your platform from the release cards at the top of this site.
2. Run the installer. On macOS you will be prompted to drag the app into /Applications; on Linux use the AppImage or the Flatpak; on Windows follow the MSI wizard.
3. Launch Which Browser once so it can register itself as a URL handler.

2. Set as Default Browser

Follow the platform-specific instructions below so that all http, https, and custom intents flow through the app.

Windows

1. Open Settings → Apps → Default apps.
2. Search for “Which Browser” and click it.
3. Assign Which Browser to HTTP, HTTPS, and .html handlers.

macOS

1. Open Safari → Settings → General and change the default web browser to Which Browser.
2. Alternatively, use System Settings → Desktop & Dock → Default web browser.

Linux (KDE example)

1. Open System Settings → Applications → Default Applications.
2. Under Web Browser, select Which Browser.
3. Verify under xdg-settings get default-web-browser that the desktop file now points to Which Browser.

3. Configure Browsers & Profiles

1. Open the Configuration dialog inside Which Browser.
2. Add each installed browser and, where supported (Chrome, Edge, Firefox), define one or more profiles.
3. Assign icons/labels so you can spot them quickly in the routing picker.

4. Route Your First Link

1. Click a link in another application. It should appear in Pending.
2. Choose a browser profile and click Open.
3. Use the Queue button to store it for later or the Snooze button to pick a specific reminder.

5. Automate

1. Create a Rule that matches a domain (for example, calendar.google.com) and pick a default target.
2. Switch to the Scripts tab and paste the snippet below to test the scripting workflow:

if (matchUrl("*.github.com/*")) {
  return action(openIn: useProfile("firefox:work"));
}

return action(openIn: useProfile("chrome:personal"));

3. Save the script, then open a GitHub URL from another app. It should auto-route without prompting you.

6. Validate Notifications

1. From Pending, choose Snooze → in 5 minutes.
2. Wait for the desktop notification to confirm reminders are working.
3. Click the notification to jump directly back to the entry inside Which Browser.

Once these steps are complete you are ready to explore the How-To Recipes and Technical Reference.