Repository files navigation

Finicky

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 link or url. With Finicky as your default browser, you can tell it to open Facebook or Reddit in one browser, and Trello or LinkedIn in another.

• Decide what urls to open in what browser or app
• Edit urls before opening them
• Complete control over configuration using JavaScript

• Getting started
• Example configuration
• Documentation
• Configuration tips
• Alternatives
• Building Finicky from source
• License

Download fromreleases

Finicky 3.4.0 is the latest stable release and should work for most use cases. Finicky 4 is under active development and available as prereleases. Note that these releases are actively being developed and can prove to be unstable and may contain bugs.

Finicky 4+ should work in MacOS 12+

// ~/.finicky.jsexportdefault{defaultBrowser:"Google Chrome",rewrite:[{// Redirect all urls to use httpsmatch:(url)=>url.protocol==="http:",url:(url)=>{url.protocol="https:";returnurl;},},],handlers:[{// Open apple.com and example.com urls in Safarimatch:["apple.com*","example.com*"],browser:"Safari",},{// Open any url that includes the string "workplace" in Firefoxmatch:/workplace/,browser:"Firefox",},{// Open google.com and *.google.com urls in Google Chromematch:["google.com*",// match google.com urls"*.google.com*",// match google.com subdomains],browser:"Google Chrome",},],};

See thedocumentation 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 all available, APIs and options as well as detail information on how to match on urls.

⚠️ Please note that Finicky 4 will affect the interface slightly, details to come⚠️

See the wiki page for otherconfiguration tips by users of Finicky.

⚠️ Please note that Finicky 4 will affect the interface slightly, details to come⚠️

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!

If you'd like to build Finicky from source:

1. Install Go 1.23.4
2. Install Node 22
3. Install dependencies inconfig-api (npm install)
4. Run./scripts/build.sh from base folder

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