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

Installation
Example configuration
Options
Function parameters
Issues
- Bugs
- Feature Requests
Questions
License
Support development
Building from source

Installation

Installation alternatives:

Download the latest release, unzip and put Finicky.app in your application folder.
Install with homebrew-cask: brew cask install finicky.

Create a file called .finicky.js with configuration (examples) in your home directory OR generate a basic configuration with Finicky Kickstart
Start Finicky. Please allow it to be set as the default browser.
And you're done. All links clicked that would have opened your browser are now first handled by Finicky.

Example configuration

Basic configuration

module.exports = {
  defaultBrowser: "Google Chrome",
  handlers: [
    {
      // Open apple.com and example.org urls in Safari
      match: finicky.matchHostnames(["apple.com", "example.org"]),
      browser: "Safari"
    },
    {
      // Open any url including the string "workplace" in Firefox
      match: /workplace/,
      browser: "Firefox"
    },
    {
      // Open google.com and *.google.com urls in Google Chrome
      match: finicky.matchHostnames([
        "google.com", // match google.com domain as string (to make regular expression less complicated)
        /.*\.google.com$/ // match all google.com subdomains
      ]),
      browser: "Google Chrome"
    }
  ]
};

Rewrite urls

module.exports = {
  defaultBrowser: "Google Chrome",
  rewrite: [
    {
      // Redirect all urls to use https
      match: ({ url }) => url.protocol === "http",
      url: ({ url }) => ({
        ...url,
        protocol: "https"
      })
    },
    {
      // Avoid being rickrolled
      match: [
        "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "https://www.youtube.com/watch?v=oHg5SJYRHA0"
      ],
      url: "about:blank"
    }
  ]
};

Advanced usage

module.exports = {
  defaultBrowser: "Google Chrome",
  options: {
    // Hide the finicky icon from the top bar
    hideIcon: true
  },
  handlers: [
    {
      // Open any link clicked in Slack in Safari
      match: ({ sourceBundleIdentifier }) =>
        sourceBundleIdentifier === "com.tinyspeck.slackmacgap",
      browser: "Safari"
    },
    {
      // You can get the path of the process that triggered Finicky (EXPERIMENTAL)
      match: ({ sourceProcessPath }) =>
        sourceProcessPath && sourceProcessPath.startsWith("/Applications/Slack.app"),
      browser: "Firefox"
    },
    {
      match: ["http://zombo.com"],
      browser: {
        name: "Google Chrome Canary",
        // Force opening the link in the background
        openInBackground: true
      }
    },
    {
      match: finicky.matchHostnames(["example.com"]),
      // Opens the first running browsers in the list. If none are running, the first one will be started.
      browser: ["Google Chrome", "Safari", "Firefox"]
    },
    {
      match: ["http://example.com"],
      // Don't open any browser for this url, effectively blocking it
      browser: null
    },
    {
      // Open links in Safari when the option key is pressed
      // Valid keys are: shift, option, command, control, capsLock, and function.
      // Please note that control usually opens a tooltip menu instead of visiting a link
      match: ({ keys }) => keys.option,
      browser: "Safari"
    }
  ]
};

Options

module.exports = {
  defaultBrowser: "Google Chrome",
  options: {
    // Hide the finicky icon from the top bar. Default: false
    hideIcon: false, 
    // Check for update on startup. Default: true
    checkForUpdate: true
  },
};

Function parameters

// Options object:
// Available as the first parameter when using match, browser or url functions.

{
  "urlString": "http://username:password@example.com:3000/pathname/?search=test#hash", // The full URL string
  "url": { // The URL parsed into parts
    "username": "username",
    "host": "example.com",
    "protocol": "http",
    "pathname": "/pathname/",
    "search": "search=test",
    "password": "password",
    "port": 3000,
    "hash": "hash"
  },  
  "keys": { // Status of modifier keys on keyboard. 
    "control": false,
    "function": false,
    "shift": false,
    "option": false,
    "command": false,
    "capsLock": false
  },
  "sourceBundleIdentifier": "net.kassett.finicky", // The bundle identifier of the application that triggered the URL to be opened. Does not work for all apps, in which case it will be null.
  "sourceProcessPath": "/Applications/Finicky.app" // The path of the application that triggered. Does not work for all apps, in which case it will be null.
}

Configuration ideas

See the wiki page for other configuration ideas

Issues

Bugs

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

Questions

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

License

MIT

Support development

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

Building from source

Install Xcode and Xcode command line tools and then run commands:

    git clone https://github.com/johnste/finicky.git
    cd finicky/Finicky
    xcodebuild

When complete you'll find a freshly built Finicky app in build/release.

portellaa / finicky