Getting started

Set up BrowserFairy in a few minutes.

Make BrowserFairy your default browser, add a couple of rules, and your links will start opening in the right place automatically.

First-run checklist

These steps give BrowserFairy complete coverage for links clicked from Mail, Slack, Finder, browser tabs, and other Mac apps.

Download BrowserFairy from the Mac App Store, open it once, and keep it in your Dock or menu bar while you finish setup.

In BrowserFairy settings, choose Set as Default Browser. macOS will ask for confirmation before every link starts passing through BrowserFairy.

Choose the browser BrowserFairy should use when no rule matches. This keeps unmatched links predictable from day one.

Start with a simple domain rule, such as company links to Chrome or social links to Firefox. Put specific rules above broad rules.

Start with rules you can recognize immediately. Once those feel right, add more specific matches for tools, accounts, and profiles.

*.company.com -> Chrome

Keeps work tabs, work logins, and company extensions together.

Source app: Slack -> Chrome

Routes links by the app that opened them, even when the URL changes.

localhost, 127.0.0.1 -> Firefox Developer

Sends local projects to the browser that already has your dev tools.

BrowserFairy can route links from Mac apps as soon as it is your default browser. Extensions add routing for links clicked inside browser tabs.

Enable the Safari extension in Safari Settings.
Install the Chrome, Edge, and Firefox extensions from their stores.
Use extensions when you want links clicked inside a browser tab to route through BrowserFairy too.

The docs cover rule order, extension setup, fallback behavior, and the most common routing issues.