Finicky — Take Full Control of Browser Choices on Mac

Finicky is a lightweight macOS application that intelligently routes links to different browsers based on URL pattern rules and JavaScript conditions. Whether you're managing multiple browsers, boosting productivity, or refining your web experience, Finicky makes it effortless.

🚀 Key Features

🔗 Intelligent URL Routing

• URL Pattern-Based: Automatically routes links to designated browsers based on domain, path, protocol, etc.
• Regular Expression Support: Enables precise matching using regex for complex URL patterns.
• JavaScript Conditions: Use JavaScript to write sophisticated routing logic and fully customize opening behavior.

🌐 Multi-Browser Support

• Seamless Switching: Works with Chrome, Safari, Firefox, Edge, Brave, and other major browsers.
• In-Browser Routing: Direct links to specific containers or user profiles within browsers (e.g., Chrome Profiles).
• Private/Incognito Mode: Configure certain links to always open in incognito or private browsing windows.

🛠️ Highly Customizable

• JSON Configuration: Define routing rules using simple JSON config files — easy to back up and sync.
• Real-Time Updates: Rules take effect immediately after modification — no restart needed.
• Launch at Startup: Optional system startup auto-launch with a persistent menu bar icon.

🎯 Flexible Use Cases

• Work-Life Separation: Automatically open work-related links (e.g., internal networks, office tools) in a dedicated browser, while personal links use another.
• Development & Debugging: Developers can route local dev server links to debugging browsers (e.g., Chrome Canary with DevTools).
• Security Isolation: Route high-security links (e.g., banks, payments) to the most secure browser.

✨ Core Advantages

✅ Boosts Productivity

No more manually copying/pasting URLs or switching between browsers. Finicky automatically routes each link to the “right” browser based on your rules, drastically reducing context-switching time.

✅ Completely Free and Open Source

✅ Lightweight Yet Powerful

The app is extremely lightweight, runs stably with minimal resource usage. Yet, through its flexible configuration, it enables complex routing logic suitable for both casual users and advanced developers.

✅ Privacy First

Finicky runs entirely locally. All routing logic is processed on your machine — no browsing data is sent to external servers, ensuring your privacy is protected.

✅ Strong Community & Documentation

Active GitHub community with comprehensive documentation. Rich examples of configuration files make it easy to get started.

📦 Installation & Usage

2. Install: Drag Finicky to the “Applications” folder.
3. Configure: On first launch, a sample config file is created at ~/.finicky.js. Edit this JS file (or use JSON format) as needed.
4. Set Permissions: In “System Settings > Privacy & Security”, grant accessibility permissions so Finicky can control browsers.
5. Enjoy: From now on, every link you click will be routed silently in the background according to your rules.

⚙️ Configuration Example

A simple ~/.finicky.js config might look like this:

module.exports = {
  defaultBrowser: "Safari",
  handlers: [
    {
      // All company internal links open in Chrome
      match: ["*.mycompany.com/*"],
      browser: "Google Chrome"
    },
    {
      // Match specific regex, open in Firefox private mode
      match: /^https?:\/\/example\.com\/private/,
      browser: {
        name: "Firefox",
        profile: "Private Browsing"
      }
    },
    {
      // Use function for complex logic
      match: ({ url }) => url.hostname === "github.com" && url.pathname.startsWith("/myproject"),
      browser: "Google Chrome Canary"
    }
  ]
}

🔗 Related Links

• Issues & Feedback: Submit via GitHub Issues

---

Ditch the chaos of browser windows — use Finicky to precisely control where every link opens. Achieve a more efficient, organized browsing experience on your Mac.