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
- Questions
- License
- Support development
- Building from source
- 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.
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"
}
]
};
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"
}
]
};
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"
}
]
};
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
},
};
// 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.
}
See the wiki page for other configuration ideas
Please file an issue for bugs, missing documentation, or unexpected behavior.
Please file an issue to suggest new features. Vote on feature requests by adding a 👍.
Have any other questions or need help? Please feel free to reach out to me on Twitter.
If you want to help support further development of finicky, feel free to buy me a coffee on ko-fi.
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
.