×

Installing Plug-Ins

For the most part, installing Omni Automation plug-in is a simple process that is based upon the file extension used by the plug-in.

Plug-In File Extensions

The file extensions used for Omni Automation plug-ins include four app-specific extensions for single-file plug-ins, matching those currently used for plug-in bundles. In addition, for plug-ins that have two or more Omni applications as targets, the generic “omnijs” file extension is used.

The five supported file extensions are:

The installation technique used for a plug-in depends upon it file extension and the operating system of the host device.

macOS: omnifocusjs, omnigrafflejs, omniplanjs, omnioutlinerjs

To install a plug-in that uses an application-specific file extension, onto a macOS device, you may either:

macOS Installation Prompt

 1  Plug-In Installation Dialog • This dialog is presented when a plug-in using an application-specific file extension is opened. The host Omni application will correspond to the file extension used by the plug-in.

 2  Plug-In File Name • The file name (or plug-in title if a bundle) of the plug-in shown without the file extension. If this plug-in has been previously installed, this name may be appended with an incrementing number.

 3  Plug-In Description • The developer-supplied description of the plug-in.

 4  Storage Destination • The folder in which the plug-in is to be installed. By default, On My Mac indicated the use of the host application’s plug-ins folder within the Application Support directory. If the current user is signed into an iClound account, the “iCloud Drive” option will be offerred along with any other linked folders.

 5  Complete Installation • Select this button to complete the copying of the chosen plug-in into the indicated destination directory.

macOS new plug-in in Automation Configuration dialog

The installed plug-in is now listed in the Automation Configuration dialog.

macOS: omnijs

Plug-ins using the generic “omnijs” file extension will not install using the previously mentioned open command or double-click.

To install plug-ins using the generic “omnijs” file extension, drag their icons into the Automation Configuration dialog.

Drag-Install Plug-Ins

After releasing the cursor, the plug-in will be automatically be copied into the destination folder the icon was dragged over.

iPadOS-configure-plug-ins

NOTE: Optionally, Plug-Ins can be moved between linked plug-in folders by dragging their icons in the Automation Configuration window.

Uninstalling Plug-Ins

To delete an installed plug-in, right-click (Control-click) the plug-in in the Automation Configuration dialog and select the “Move to Trash” option from the forthcoming contextual menu:

Deleting installed Plug-In

iPadOS/iOS: omnifocusjs, omnigrafflejs, omniplanjs, omnioutlinerjs

To install a plug-in using an app-specific file extension, simply tap the plug-in’s icon and the installation dialog will be summoned:

iPadOS-configure-plug-ins

 1  Plug-In Installation Dialog • This dialog is presented when a plug-in using an application-specific file extension is opened. The host Omni application will correspond to the file extension used by the plug-in.

 2  Plug-In File Name • The file name (or plug-in title if a bundle) of the plug-in shown without the file extension. If this plug-in has been previously installed, this name may be appended with an incrementing number.

 3  Plug-In Details • The developer-supplied description of the plug-in.

 4  Storage Destination • The folder in which the plug-in is to be installed. By default, On My Mac indicated the use of the host application’s plug-ins folder within the Application Support directory. If the current user is signed into an iClound account, the “iCloud Drive” option will be offerred along with any other linked folders (see below).

 5  Complete Installation • Select this button to complete the copying of the chosen plug-in into the indicated destination directory.

iPadOS-default-source-folder.png

The installed plug-in is now listed in the Automation Configuration dialog.

iPadOS-installed-plug-in

iPadOS/iOS: omnijs

Installing plug-ins that use the generic “omnijs” file extension is done easily by following this process:

on-my-ipad

The installed plug-in will appear in the target application’s Automation or Share menu.

Uninstalling Plug-Ins

To delete an installed plug-in, swipe left on the plug-in in the “Configure Plug-Ins” dialog, and then tap the “Delete” button:

Removing installed plug-in