Repository files navigation

Always open the right browser

Finicky is a macOS application that allows you to set up rules that decide which browser is opened for every url. With Finicky as your default browser, you can tell it to open Bluesky or Reddit in one browser, and LinkedIn or Google Meet in another.

• Route any URL to your preferred browser with powerful matching rules
• Automatically edit URLs before opening them (e.g., force HTTPS, remove tracking parameters)
• Write rules in JavaScript or TypeScript for complete control
• Create complex routing logic with regular expressions and custom functions
• Handle multiple browsers and apps with a single configuration
• Keep your workflow organized by separating work and personal browsing

• Installation
• Basic configuration
• Configuration
• Migrating from Finicky 3

• Download fromreleases
• Or install via homebrew:brew install --cask finicky
• Create a JavaScript or TypeScript configuration file at~/.finicky.js. Have a look at the example configuration below, or in theexample-config folder.
• Start Finicky (in Applications, or through Spotlight/Alfred/Raycast) and allow it to be set as the default browser. Starting Finicky manually opens the configuration/troubleshooting window.

Here's a short example configuration that can help you get started

// ~/.finicky.jsexportdefault{defaultBrowser:"Google Chrome",rewrite:[{// Redirect all x.com urls to use xcancel.commatch:"x.com/*",url:(url)=>{url.host="xcancel.com";returnurl;},},],handlers:[{// Open all bsky.app urls in Firefoxmatch:"bsky.app/*",browser:"Firefox",},{// Open google.com and *.google.com urls in Google Chromematch:["google.com/*",// match google.com urls"*.google.com*",// also match google.com subdomains],browser:"Google Chrome",},],};

See theconfiguration for all the features Finicky supports.

Finicky has extensive support for matching, rewriting and starting browsers or other application that handle urls. See the wiki for thefull configuration documentation explaining available, APIs and options as well as detail information on how to match on urls.

• The wiki has some goodconfiguration ideas.
• Visitdiscussions to discuss supporting specific apps.

Please see thewiki page for updating info and migrating your configuration

Finicky has browser extensions for Chrome and Firefox. They add an "open with Finicky" on links, and alt-clicking links opens them in Finicky directly.

• Firefox Add-ons
• Chrome Web Store

SeeBuilding Finicky from source

If you are looking for something that lets you pick the browser to activate in a graphical interface, check outBrowserosaurus by Will Stone, an open source browser prompter for macOS. It works really well together with Finicky!

Have any other questions or need help? Please feel free to reach out to me onBluesky or post an issue here

MIT

Icon designed by@uetchy