Choosy

Help: Rules settings

This page describes the settings on Choosy's “Rules” tab. To find these settings launch the Choosy app (from Finder, Launchpad, etc.) and then click on the Rules tab.

Rules allow you to define how Choosy will behave in specific circumstances.

  1. Adding and editing rules
  2. Ordering rules
  3. Disabling rules

Adding and editing rules

To add a rule, click on the plus button below the list of rules.

To edit a rule double click on the rule in the list, or select the rule in the list and then click the “Edit selected rule” button on the right hand side below the list.

When adding or editing rules this window will be displayed:

A screenshot of Choosy's rule editing interface

This window contains three groups of options:

  1. General rule settings
  2. When Choosy should use this rule
  3. What Choosy should do when it uses this rule

General rule settings

Title

The title setting is located at the top of the rule editing window. It allows you to give the rule a name that will be displayed in the rules list. Choose something specific enough to distinguish this from other rules.

Enabled

The enabled checkbox is located at the bottom of the rule editting window. This allows you to disable rules without deleting them. If a rule is not enabled (i.e. if this box is not checked) then Choosy will ignore the rule.

When Choosy should use this rule

This section allows you to define the conditions that must be met in order for Choosy to use the rule.

The first row of the rule editor lets you select what type of rule it is, and which of the rules criteria (any, all or none) must be met for the rule to be triggered:
A screenshot of the first row of the rule editor

The subsequent rows of the rule editor show the different criteria that make up the rule. You can add new criteria by clicking on the plus button at the end of any row, and you can remove a criteron by clicking on the minus button at the end of its row:
A screenshot of a criteron row in the rule editor

The dropdown list at the beginning of the row lets you select what this criterion will match. The rest of the options in the row will depend on what type of criterion it is. Some types will have several options, others will have a text box where you can type in a value.

The following types of criteria are available:

Web address
A screenshot of a web address criteron row in the rule editor

This allows rules to be set up for certain web sites, or groups of web sites. For example you could use this type of criterion to set up a rule that sends all links to google.com to Firefox.

Web address criteria are very flexible: You can match exact addresses, addresses that start with, end with or contain certain words or even addresses that match patterns and regular expressions. The web address rules section describes these options in more detail.

Source application
A screenshot of a source application criteron row in the rule editor

This allows rules to be created that will be triggered when you click on a link in a specific application. The browse button lets you pick an application from your Applications folder (or elsewhere on your Mac).

By selecting “is not” in the second dropdown list, you can also create rules that target links from all source applications except for the application selected in this row.

Link type
A screenshot of a link type criteron row in the rule editor

Link type lets you select from the following options:

  • a link to a web site
  • an HTML file on your computer

This lets you set up rules that only apply either to HTML files on your computer, or to links to web sites. For example you might want to set up a custom prompt for HTML files on your computer that includes editing tools that wouldn't be able to open normal web links.

Number of running browsers
A screenshot of a running browsers criteron row in the rule editor

This lets you set up rules that only trigger when a certain number of browsers are running, or when more than or less than a certain number of browsers are running. The second dropdown list lets you select from the following options:

  • is
  • is not
  • is less than
  • is greater than

The third dropdown list lets you select a number from 0 to 10.

When you click on a link the number of running browsers is calculated as the number of applications from your browsers list that are currently running.

Modifier keys
A screenshot of a modifier keys criteron row in the rule editor

This type of criterion lets you set up rules that are only triggered when you are holding down a modifier key or a combination of modifier keys when you click on the link.

This is useful for behaviours that you only want to occur sometimes. For example you could set up most of your rules to never prompt you to select a browser, with a single rule to prompt you to select from all browsers when you hold shift while clicking on a link.

Modifier keys criteria can use combinations of the following keys:

  • ⇧ Shift
  • ⌃ Control
  • ⌘ Command (sometimes called “Apple”)
  • ⌥ Option (sometimes called “alt”)
  • ⇥ Tab
  • ⎋ Escape
Custom API method
A screenshot of a custom API method criteron row in the rule editor

Custom API methods let you extend Choosy's API and add your own behaviours to it.

If you were to create a rule that responded to a custom API method called “my.rule” you would trigger it in the same way as any other API method, e.g. by loading the URL x-choosy://my.rule/https://www.google.com

The custom API methods page contains more information about creating and using your own custom API methods.

URL shortening service
A screenshot of a short URL criteron row in the rule editor

This type of cirterion allows you to define rules that are only triggered when Choosy opens a link to a URL shortening service, like bit.ly or tinyurl.

This is useful when combined with the short URL expansion settings. You can tell Choosy to always prompt when opening short URLs so that you will be able to check the expanded URL in the prompt before you open the site in a browser.

A list of supported URL shortening services, and instructions for adding your own are in the short URL expansion section on the advanced settings page.

Airdrop

Using this criterion allows you to specify what should happen when a URL is sent to your Mac from another Apple device using Airdrop.

Share extension

Choosy appears in the Share menu in other macOS apps. This criterion allows you to specify what Choosy should do when URLs are sent to it via the Share menu.

Handoff

Handoff allows you to resume an activity from one of your other Apple devices on your Mac, for example when you're browsing the Web in Safari on your iPhone you can continue lookin at the same page on your Mac.

As your default browser, Choosy is sent URLs from your other devices when you use Handoff, and you can use this criterion to define specific behaviour that Choosy should follow.

What Choosy should do when it uses this rule

At the bottom of the rule editing window are the rule's behaviour settings. This is where you tell Choosy what to do when all the rule's criteria match the link that is being clicked.

The following behaviours are available:

Use the default behaviour
Choosy will skip forward to the default rule at the end of the rules list and use its behaviour, just as it would have done if no rules had been triggered.
Use my favourite browser
Choosy will use the browser at the top of your browsers list.
Use the best running browser
Choosy will use the running browser closest to the top of your browsers list. If no browsers are running, Choosy will use the browser at the top of your browsers list.
Prompt to select from all browsers
Choosy will prompt you to select from all the browsers in your browsers list.
Prompt to select from running browsers
Choosy will prompt you to select from all the browsers in your browsers list that are currently running. If no browsers are running, Choosy will prompt you to select from all of the browsers in your browsers list.
Prompt to select from these browsers …

Choosy will prompt you to select from a custom list of browsers that you set up only for this rule. When you select this option an interface very similar to the browsers list will appear where you can set up a custom browser list.

A screenshot of Choosy's "prompt to select from these browsers" interface
Always use this browser …

Choosy will always use the same browser. When you select this option an interface will appear that allows you to select the browser that Choosy should always use with this rule.

A screenshot of Choosy's "always use this browser" interface
Use all of these browsers …

Choosy will open all of the browsers you specify. The browsers will be opened in the order that you specify. When you select this option an interface very similar to the browsers list will appear where you can set up a custom browser list.

A screenshot of Choosy's "use all of these browsers" interface
Open the macOS Share menu

Choosy will open the Share menu, allowing you to send the link to a variety of non-browser apps.

The exact set of options on this menu will vary depending on the apps you have installed on your Mac, but they will typically allow you to send the link to another person (e.g. using Messages, Mail, or AirDrop), or to save the link somewhere (e.g. in Notes or Reminders).

Use this sharing service …

Choosy will send the link directly to a specific item in the macOS Share menu.

For example, if you make frequent use of Apple's Reminders app, you could create a Choosy rule to send links directly to Reminders whenever you hold down a particular key combination while clicking on a link.

Ordering rules

The order of your rules is important. When more than one rule matches the current situation Choosy will use the rule that is nearest to the top of the list. This means that a very general rule would take priority over a very specific rule when both rules match but the general rule is higher up the list.

To change the order of the rules, drag and drop each rule into a new position.

The last rule in the list defines the default behaviour that Choosy will fall back on if no other rule matched. This rule supports all the same behaviours as normal rules, but you cannot edit the conditions in which it applies, or move it out of its position at the end off the list.

Disabling rules

The checkboxes in the list of rules allow you to disable rules without removing them completely. If a rule's checkbox is not checked then Choosy will ignore that rule.