Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/johnste/finicky

A macOS app for customizing which browser to start
https://github.com/johnste/finicky

browser handler macos menu productivity swift typescript url xcode

Last synced: about 21 hours ago
JSON representation

A macOS app for customizing which browser to start

Awesome Lists containing this project

README 

        


  


finicky logo

  



  🇺🇦 Always open the right browser 🇺🇦


  [![GitHub start](https://badgen.net/github/stars/johnste/finicky?color=pink&icon=github)](https://GitHub.com/johnste/finicky/)

  [![GitHub release](https://badgen.net/github/release/johnste/finicky/stable?color=purple)](https://GitHub.com/johnste/finicky/releases/)






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





Finicky screenshot




## Table of Contents



- [Installation](#installation)

- [Example configuration](#example-configuration)

- [Documentation](#documentation)

- [Configuration tips](#configuration-tips)

- [Alternatives](#alternatives)

- [Building Finicky from source](#building-finicky-from-source)

- [Current status of Finicky development](#current-status-of-finicky-development)

- [Issues](#issues)

  - [Bugs](#bugs)

  - [Feature Requests](#feature-requests)

  - [Questions](#questions)

- [License](#license)



## Installation



1. Installation alternatives:



- Download [the latest release](https://github.com/johnste/finicky/releases), unzip and put `Finicky.app` in your application folder.

- Install with [homebrew-cask](https://github.com/caskroom/homebrew-cask): `brew install --cask finicky`.



2. Create a file called `.finicky.js` with configuration

   ([examples](#example-configuration)) in your home directory OR generate a basic configuration with [Finicky Kickstart](https://finicky-kickstart.now.sh/)



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



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



## Example configuration



```js

// ~/.finicky.js



module.exports = {

  defaultBrowser: "Google Chrome",

  rewrite: [

    {

      // Redirect all urls to use https

      match: ({ url }) => url.protocol === "http",

      url: { protocol: "https" }

    }

  ],

  handlers: [

    {

      // Open apple.com and example.com urls in Safari

      match: finicky.matchHostnames(["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](#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](https://github.com/johnste/finicky/wiki/Configuration) explaining all available, APIs and options as well as detail information on how to match on urls.



## Configuration tips



See the wiki page for other [configuration tips](https://github.com/johnste/finicky/wiki/Configuration-ideas) by users of Finicky.



## Alternatives



If you are looking for something that lets you pick the browser to activate in a graphical interface, check out [Browserosaurus](https://browserosaurus.com/) 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, you can do so by installing Xcode, Xcode Command Line Tools, and yarn, and then running the following:



```sh

# build the source

make



# run the compiled app

make run

```



## Current status of Finicky development



I don't have time to work on Finicky actively, and that has been the case for several years. I still use it every day and it works really well for my use cases. When I have time I try to respond to support requests on twitter and github.



Don't expect any work on features, new releases, or even bug fixes on my part at this point. Unless things change a lot in my personal or professional life I won't have time to work on Finicky for the forseeable future.



### Looking for co-maintainers



Do you want to help out with the development of Finicky? My time to spend to work on Finicky is very limited, and my limited experience with Swift and MacOS I feel is holding it back. If you are experienced in Swift and MacOS development and this sounds interesting to you please reach out to me, preferably on [Twitter](https://twitter.com/johnste_).



## Issues



### Bugs



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



[**See Bugs**](https://github.com/johnste/finicky/issues?q=is%3aopen+is%3aissue+label%3abug)



### Feature Requests



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

a 👍.



[**See Feature Requests**](https://github.com/johnste/finicky/labels/feature%20request)



### Questions



Have any other questions or need help? Please feel free to reach out to me on [Mastodon](https://mastodon.se/@john) or [Twitter](https://twitter.com/johnste_).



## License



[MIT](https://raw.githubusercontent.com/johnste/finicky/master/LICENSE)