README.md

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

Table of Contents

• Installation
• Example configuration
• Documentation
• Configuration tips
• Alternatives
• Building Finicky from source
• Current status of Finicky development
• License

Installation

1. Installation alternatives:

You have to build it from source currently.

Example configuration

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

See the documentation for all the features Finicky supports.

Documentation

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.

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

Configuration tips

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

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

Alternatives

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!

Building Finicky from source

If you'd like to build Finicky from source:

./scripts/build.sh

Current status of Finicky development

I am currently working on the next version of Finicky, rewritten in Go.

Questions

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

License

MIT

Icon designed by @uetchy