BrowserFairyBrowserFairy

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.

BrowserFairy fairy pointing at browser route signs

First-run checklist

From install to your first working rule.

01

Install BrowserFairy

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

Download Free
02

Make it your default browser

Right after you install BrowserFairy, set it as your default browser so every link from your Mac apps starts passing through your rules. Here is the whole flow from first launch.

Open BrowserFairy once, choose Set as Default Browser, and confirm the macOS prompt. From then on, links route automatically.
03

Pick your fallback browser

Choose the browser BrowserFairy should use when no rule matches. This keeps unmatched links predictable from day one, and you can change it any time in Settings.

04

Create your first rule

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

Rules editor
Open link withGoogle Chromewhen
Anyof the following are true
Link addressbegins withhttps://github.com/

Matches the web address, so every GitHub link opens in Chrome.

Rules editor
Open link withSafariwhen
Anyof the following are true
Link clickedinMail

Matches the app the link came from, so anything you open in Mail goes to Safari.

Read the walkthrough
05

Configure the Browser Launcher

The Browser Launcher is a floating picker for choosing a browser, and sometimes a profile, by hand. In Settings, pick which browsers appear and in what order so it is ready whenever you would rather decide than let a rule choose.

About the Browser Launcher
06

Open it with a keyboard shortcut

Press the global shortcut to summon the launcher from any app and open a link in a fresh window. You can change or clear it any time in Settings under Keyboard.

Default shortcutB
Set the shortcut

Add the extension for your browsers

As your default browser, BrowserFairy already routes links from Mac apps like Mail and Slack, so this step is optional. Extensions cover the one case default routing cannot reach: links you click while you are already inside a browser. Add the extension for any browser you use that way.

Not sure which you need? See how extensions work.

Need a hand after setup?

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

Read Docs