{"id":13493427,"url":"https://github.com/johnste/finicky","last_synced_at":"2025-05-13T21:06:33.919Z","repository":{"id":33666477,"uuid":"37319088","full_name":"johnste/finicky","owner":"johnste","description":"A macOS app for customizing which browser to start","archived":false,"fork":false,"pushed_at":"2025-05-13T18:36:46.000Z","size":3991,"stargazers_count":3994,"open_issues_count":27,"forks_count":153,"subscribers_count":27,"default_branch":"main","last_synced_at":"2025-05-13T19:41:17.247Z","etag":null,"topics":["browser","go","handler","macos","menu","productivity","typescript","url"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/johnste.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"johnste","patreon":null,"open_collective":null,"ko_fi":"johnste","tidelift":null,"custom":null}},"created_at":"2015-06-12T11:46:13.000Z","updated_at":"2025-05-13T18:39:49.000Z","dependencies_parsed_at":"2024-12-25T18:04:33.964Z","dependency_job_id":"529ff1ca-ae26-48e0-a786-ce4163d38a25","html_url":"https://github.com/johnste/finicky","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnste%2Ffinicky","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnste%2Ffinicky/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnste%2Ffinicky/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johnste%2Ffinicky/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/johnste","download_url":"https://codeload.github.com/johnste/finicky/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254028790,"owners_count":22002277,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser","go","handler","macos","menu","productivity","typescript","url"],"created_at":"2024-07-31T19:01:15.108Z","updated_at":"2025-05-13T21:06:33.913Z","avatar_url":"https://github.com/johnste.png","language":"Go","readme":"\u003cdiv align=\"center\"\u003e\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/user-attachments/assets/ab66e6cc-25d1-4f5f-9c98-c742ecb2261f\"\u003e\n  \u003cimg alt=\"Finicky Logo\" height=\"110\" src=\"https://github.com/user-attachments/assets/067d7619-a2be-49dd-8a4f-5e9a46fa632a\"\u003e\n\u003c/picture\u003e\n\u003cbr/\u003e\u003cbr/\u003e\n \u003cstrong\u003eAlways open the right browser\u003c/strong\u003e\u003cbr\u003e\n    \u003cbr/\u003e\n\n\u003c/div\u003e\n\nFinicky is a macOS application that allows you to set up rules that decide which browser is opened for every url. With Finicky as your default browser, you can tell it to open Bluesky or Reddit in one browser, and LinkedIn or Google Meet in another.\n\n- Route any URL to your preferred browser with powerful matching rules\n- Automatically edit URLs before opening them (e.g., force HTTPS, remove tracking parameters)\n- Write rules in JavaScript or TypeScript for complete control\n- Create complex routing logic with regular expressions and custom functions\n- Handle multiple browsers and apps with a single configuration\n- Keep your workflow organized by separating work and personal browsing\n\n[![GitHub prerelease](https://badgen.net/github/release/johnste/finicky?color=purple)](https://GitHub.com/johnste/finicky/releases/) ![MIT License](https://badgen.net/github/license/johnste/finicky) ![Finicky v4 release](https://badgen.net/github/milestones/johnste/finicky/6?color=pink)\n\n## Table of Contents\n\n- [Install](#install)\n- [Basic configuration](#basic-configuration)\n- [Configuration](#documentation)\n\n## Install\n\n- Download from [releases](https://github.com/johnste/finicky/releases)\n- Or install via homebrew: `brew install --cask finicky`\n\n## Basic configuration\n\nHere's a short example configuration that can help you get started\n\n```js\n// ~/.finicky.js\nexport default {\n  defaultBrowser: \"Google Chrome\",\n  rewrite: [\n    {\n      // Redirect all x.com urls to use xcancel.com\n      match: \"x.com/*\",\n      url: (url) =\u003e {\n        url.host = \"xcancel.com\";\n        return url;\n      },\n    },\n  ],\n  handlers: [\n    {\n      // Open any url that includes the string \"workplace\" in Firefox\n      match: \"bsky.app/*\",\n      browser: \"Firefox\",\n    },\n    {\n      // Open google.com and *.google.com urls in Google Chrome\n      match: [\n        \"google.com/*\", // match google.com urls\n        \"*.google.com*\", // also match google.com subdomains\n      ],\n      browser: \"Google Chrome\",\n    },\n  ],\n};\n```\n\nSee the [configuration](#configuration) for all the features Finicky supports.\n\n## Configuration\n\nFinicky has extensive support for matching, rewriting and starting browsers or other application that handle urls. See the wiki for the [full configuration documentation](\u003chttps://github.com/johnste/finicky/wiki/Configuration-(v4)\u003e) explaining available, APIs and options as well as detail information on how to match on urls.\n\n- The wiki has some good [configuration ideas](https://github.com/johnste/finicky/wiki/Configuration-ideas).\n- Visit [discussions](https://github.com/johnste/finicky/discussions) to discuss supporting specific apps.\n\n# Other\n\n### Building Finicky from source\n\nSee [Building Finicky from source](https://github.com/johnste/finicky/wiki/Building-Finicky-from-source)\n\n### Works well with\n\nIf 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!\n\n### Questions\n\nHave any other questions or need help? Please feel free to reach out to me on [Bluesky](https://bsky.app/profile/mejkarsense.se) or post an issue here\n\n## License\n\n[MIT](https://raw.githubusercontent.com/johnste/finicky/master/LICENSE)\n\nIcon designed by [@uetchy](https://github.com/uetchy)\n","funding_links":["https://github.com/sponsors/johnste","https://ko-fi.com/johnste"],"categories":["Swift","Go","Applications","Workflow","TypeScript","Browser","Developer Tools","typescript","Uncategorized"],"sub_categories":["Browser","Developer Utilities","🌐 Browser (13)","Uncategorized"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnste%2Ffinicky","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohnste%2Ffinicky","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohnste%2Ffinicky/lists"}