Awesome Open Source
Awesome Open Source

finicky logo

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

GitHub start GitHub release

Finicky screenshot

Table of Contents


  1. Installation alternatives:
  1. Create a file called .finicky.js with configuration (examples) in your home directory OR generate a basic configuration with Finicky Kickstart

  2. Start Finicky. Please allow it to be set as the default browser.

  3. And you're done. All links clicked that would have opened your browser are now first handled by Finicky.

Example configuration

// ~/.finicky.js

module.exports = {
  defaultBrowser: "Google Chrome",
  rewrite: [
      // Redirect all urls to use https
      match: ({ url }) => url.protocol === "http",
      url: { protocol: "https" }
  handlers: [
      // Open and urls in Safari
      match: ["*", "*"],
      browser: "Safari"
      // Open any url that includes the string "workplace" in Firefox
      match: /workplace/,
      browser: "Firefox"
      // Open and * urls in Google Chrome
      match: [
        "*", // match urls
        finicky.matchDomains(/.*\ // use helper function to match on domain only
      browser: "Google Chrome"

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

Configuration ideas

See the wiki page for other configuration ideas by users of Finicky.


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

Support development

If you want to help support further development of finicky, feel free to buy me a coffee on ko-fi.

Buy Me a Coffee at



Please file an issue for bugs, missing documentation, or unexpected behavior.

See Bugs

Feature Requests

Please file an issue to suggest new features. Vote on feature requests by adding a 👍.

See Feature Requests


Have any other questions or need help? Please feel free to reach out to me on Twitter.



Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
swift (7,253
macos (1,518
xcode (451
browser (414
productivity (212
menu (156
url (81
handler (36

Find Open Source By Browsing 7,000 Topics Across 59 Categories