Enabled

If you aren’t planning to use OpenIn for handling mailto: links on your Mac, you can disable it completely, so OpenIn will not try to check if other apps are set as the default for handling mail links.

Applications

Remove all applications

OpenIn automatically discovers applications that can be used as Mail Apps on your system. You can remove all applications and rebuild the list on your own.

Add application…

OpenIn shows a dialog with all the applications that can be used as Mail Apps found on your system. If you are planning to rewrite the URL to a different scheme, or use a browser with a web mail app, you can add it here.

Select applications from the Add applications list and press Add to add them to the list of applications for mail apps.

You can add the same application more than once - that helps, for example, to configure them differently. For example, to use the same browser but with different web mail sites.

Order of the applications

OpenIn uses the defined order of the applications when it shows the App Selection menu when you click the link. You can change the order by dragging applications by ≋.

Edit application

Based on the type of the application, you might see slightly different configurations.

• Name - you can give any name to the application; it does not change the name of the app on the system.
• Icon overlay - you can add an icon overlay. This is useful if you, for example, add the same browser or application with different configurations.

Safari and Firefox Private Mode

Please read information how to configure Safari Private Mode in the Browsers section

Chromium profiles

Please read information how to configure Chromium Profiles in the Browsers section

URL Rewrite

If you have added an application that does not support the mailto: scheme, you need to rewrite the URL to a supported scheme. You will see a warning if you aren’t rewriting the URL, and OpenIn discovered that the editing application does not support the mailto: scheme.

You can rewrite URLs with JavaScript. Click the Edit script… button to modify the script.

OpenIn provides two examples of how to rewrite mailto: links to https:// links to open with a browser for Gmail and Fastmail.

For learning more about what objects are available, please read 07. JavaScript Editor for Apps.

How to configure OpenIn to use other email services as a Mail Application?

You need to find a correct URL that will allow composing a new message. In this URL you need to find a way to pass to, subject, body, cc and bcc as parameters. The most important is to.

Launch Configurations

You can configure how OpenIn launches the application

• New instance - Whether you want the system to launch a new instance of the app. For Chromium browsers to be able to open a URL in a specific profile, we always need to launch a new instance of the browser. The same applies to Safari in Private mode.
• Adds To Recent Items - Whether to add the app or documents to the Recent Items menu, if the application supports that.
• Activates - Whether the system activates the app and brings it to the foreground. You can uncheck this to launch the URL in the background.
• Hides - Whether you want the app to hide itself after it launches.
• Hides Others - Whether you want to hide all apps except the one that launched.

Rules

Rules help you organize how OpenIn uses selected applications. If no rules are defined, it will show the selected apps in the App Selection menu when you click the mailto: link. Similarly, if no rules match conditions, OpenIn will just show the list of applications from above.

In the list you can edit or remove rules.

Order of the rules

The order of the rules matters. OpenIn goes from the first rule of the list to the next one, verifying if the conditions are met. The first that matches conditions will be executed. You can change the order of the rules by dragging ≋.

Edit rule

You can configure the Name of the Rule to help you identify it. If you aren’t satisfied with the rule yet, you can Disable it while trying to figure out what works best for you.

Conditions

You have several conditions to configure. If you have specified multiple conditions they will work as AND, except multiple domain matches and multiple sent-from apps are executed as OR in those lists.

Execute when

• With key Modifiers - you can configure this rule to execute only when those key modifiers are pressed when you click the link.

Execute with Focus

OpenIn can be configured based on the selection of System Focus. OpenIn cannot read which focus is set, but you can configure Focus Hints parameters that you can use with the Focus editor in the System Settings. And when the Focus Hint matches the one configured in the rule, this rule will be executed.

To learn more, please review Tutorial: Configuring rules based on the Focus selected in macOS system.

Matches domains

You can add one or more domain matches. In case you configured multiple domains, just one of them needs to be matched. Use * for matching.

Examples:

• *@example.com matches both user1@example.com and user2@example.com

Sent from apps

You can configure this to execute this rule only when a mailto: link is sent from a specific application. In case you configured multiple applications in this list, just one of them needs to be matched.

Use applications

You can configure how this Rule shows applications defined in the list of applications.

• All - all applications from the list will be used
• All (running) - only running applications will be shown. If none of the applications are running, this rule is skipped.
• Selected - only applications that you have selected in the list will be used.
• Selected (running) - only running applications that you have selected in the list will be used. If none of the applications are running, this rule will be skipped.

Custom script

You can define your custom JavaScript to change the URLs or select the mail apps based on your own custom conditions.

For learning more about what objects are available, please read 08. JavaScript Editor for Rules.

Example: how author of OpenIn uses the OpenIn

The list of applications I have:

• Mail - standard Mail.app instance without any changes to the configurations.
• Chrome (OS) - Chrome browser with configured work profile and rewrite rule for Gmail.
• Fastmail - Safari browser with rewrite rule to use Fastmail as a web email client

In the rules I have the next set of rules:

• Cmd - With Key Modifiers ⌘ and All apps.
• Default - My default rule with only one Mail app.

With this configuration, in most cases my mailto: links are opened in Mail.app, and when I press ⌘ I have the selection of all mail apps defined.