Choosy

Choosy is a browser chooser for macOS. Protocol Launcher allows you to generate URLs that open web links with Choosy.

Usage

There are two ways to use this library:

• On-Demand import from subpaths enables tree-shaking and keeps bundles small.
• Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand

Recommended. Optimized for production.

Full Import

Convenient. Good for quick scripts.

Notes

This module follows Choosy's official API documentation, where a URL is shaped as x-choosy://api-method/web-url.

The built-in helpers only cover the official API methods documented by Choosy: open, prompt.all, prompt.running, best.all, and best.running. Choosy also documents user-defined custom API methods, so customApiMethod accepts the method name configured in your Choosy rules.

Open

On-Demand

import { open } from 'protocol-launcher/choosy'

const url = open({
  url: 'https://example.com',
})

Open with Choosy settings

Prompt All

On-Demand

import { promptAll } from 'protocol-launcher/choosy'

const url = promptAll({
  url: 'https://www.georgebrock.com',
})

Prompt from all browsers

Prompt Running

On-Demand

import { promptRunning } from 'protocol-launcher/choosy'

const url = promptRunning({
  url: 'https://example.com',
})

Prompt from running browsers

Best All

On-Demand

import { bestAll } from 'protocol-launcher/choosy'

const url = bestAll({
  url: 'https://example.com',
})

Use favourite browser

Best Running

On-Demand

import { bestRunning } from 'protocol-launcher/choosy'

const url = bestRunning({
  url: 'https://example.com',
})

Use favourite running browser

Custom API Method

On-Demand

import { customApiMethod } from 'protocol-launcher/choosy'

const url = customApiMethod({
  method: 'edit',
  url: 'https://www.example.com',
})

Use custom API method

Official Documentation

• Choosy API
• Choosy custom API methods