OmniFocus 4: What’s New in Omni Automation?

Since Automation is an essential component of all Omni products, as the abilities of OmniFocus increase, so does its repertoire of automation features and tools. This page highlights some of the new elements of automation control for OmniFocus 4. Enjoy!

(New to Omni Automation? Here’s how to enable the Automation tools in OmniFocus.)

⭐️⭐️⭐️⭐️ Automation Updates in OmniFocus 4 ⭐️⭐️⭐️⭐️

⭐️ Beginning with OmniFocus 4, the textual content of project and task notes supports Rich Text formatting. This means that text in notes can be sized, colored, and styled, and may also contain specialized text objects such as links and inline attachments.

Documentation:

⭐️ Also new in OmniFocus 4, access to the hierarchal outline of OmniFocus elements displayed in a window is accessible via Omni Automation.

An outline is a hierarchical structure comprised of ordered nodes, each of which may contain other nodes, each of which may contain other nodes, and so on.

A node is an organizational wrapper for an instance of the OmniFocus DatedObject class, such as a folder, project, tag, or task.

Access is provided for both the window “content tree” and “sidebar tree” of nodes.

Documentation:

⭐️ Also new in OmniFocus 4, robust support for Apple’s built-in Voice Control, including “speakable menus” (macOS) and hundreds of installable custom commands (iOS · iPadOS · macOS)

Documentation:

⭐️ In OmniFocus 4, you can now use “Quick Open” to locate, select, and launch installed Omni Automation plug-ins (iOS · iPadOS · macOS)

Videos

The following videos highlight some of these new automation abilities by demonstrating some common use-case scenarios.

DISCLAIMER: Mention of third-party websites and products is for informational purposes only and constitutes neither an endorsement nor a recommendation. OMNI-AUTOMATION.COM assumes no responsibility with regard to the selection, performance or use of information or products found at third-party websites. OMNI-AUTOMATION.COM provides this only as a convenience to our users. OMNI-AUTOMATION.COM has not tested the information found on these sites and makes no representations regarding its accuracy or reliability. There are risks inherent in the use of any information or products found on the Internet, and OMNI-AUTOMATION.COM assumes no responsibility in this regard. Please understand that a third-party site is independent from OMNI-AUTOMATION.COM and that OMNI-AUTOMATION.COM has no control over the content on that website. Please contact the vendor for additional information.

▶︎ Text Objects, Style Attributes, and Inline Attachments

The ability to format note text and access its component elements, known as “text objects,” opens up numerous avenues for refining and enhancing the expression of your data. For instance, you can easily modify the text formatting in a project or task note.

Video 8: Text Style Attributes
Example: Formatting the text of a note

Related Plug-Ins

Here are links to the plug-ins demonstrated in the video:

Including Tabbed Data

The ability to format note text and to access its component elements (“text objects”) enables countless new ways to refine and enhance the expression of your data. Here’s a practical example involving the use of tabbed data in a project or task note:

Video 1: Text Objects, Style Attributes, and Inline Attachments
Example: Adding spreadsheet data to a note

Related Plug-Ins

Here are links to the plug-ins demonstrated in the video:

And here’s a link to the example Numbers spreadsheet:

Inline Map Image

In the next example, an Omni Automation plug-in uses the online Mapbox service to generate and add a static map image using the first map URL stored in the notes of the selected project or task.

The plug-in leverages OmniFocus 4's Rich Text support to scan the selected task or project's note for map links. If a link is found, its latitude and longitude coordinates are extracted and used to create a static map of the location. The generated map image is then added as an inline text attachment to the note.

Video 6: Text Objects, Style Attributes, and Inline Attachments
Example: Adding static map to a note

Related Resources

Here are links to the automation tools demonstrated in the video:

▶︎ Link Objects

Links serve as “connection points” to related data, media, or information. Often, they are expressed in the form of intricate URLs that needlessly take up space and are confusing in their appearance.

Creating “Link Objects” that encapsulate the complexity of a link within a container represented by a selected word or phrase can be a time-consuming process.

However, with the new text manipulation capabilities in Omni Automation for OmniFocus 4, Link Objects can be swiftly and effortlessly created and edited using standard Markdown syntax. Here are a few examples in action:

Video 2: Text Objects and Style Attributes
Example: Links to Markdown | Markdown to Links

Related Plug-Ins

Here are links to the plug-ins demonstrated in the video:

Sometimes links are the fastest way to navigate between OmniFocus elements, including: Folders, Project, Tasks, and Tags! Here’s an example:

 

Video 3: Text Objects and Style Attributes
Example: “Jump Links”

Related Plug-Ins

Here are links to the plug-ins demonstrated in the video:

▶︎ Window Sidebar and Content “Node Trees”

The new sidebar and content properties of the Window class enable scripts to “see” and “interact” with the hierarchical node trees displayed in OmniFocus windows.

In practical terms, this means that folders, tags, projects, and tasks can be revealed, selected, focused, expanded, and contracted using automation.

Video 4: Window Content Outline
Example: Reveal Select and Adjust Tasks

Related Plug-Ins

Here are links to the plug-ins demonstrated in the video:

▶︎ Voice Control Support

Dramatic enhancements to Omni Automation provide Voice Control with the ability to interact with OmniFocus 4 through spoken commands and dictation, on iPhones, iPads, and Macs.

Video 5: Voice Control Support
Example: Dictate Grocery List (macOS)

Related Documentation and Resources

Here are links to OmniFocus Voice Control documentation, plug-ins, and installable Voice Control command sets:

Window Panel Controls

The OmniFocus 4 scripting API includes two new properties of the Window class for controlling window panels: inspectorVisible and sidebarVisible

These properties can be used to manage the window view. For example, here’s a video showing them used with Voice Control:

Video 7: Window Panel Controls
Showing and Hiding Inspector and Sidebar

Related Documentation and Resources

Here is the link to OmniFocus Voice Control documentation and installable Voice Control command set for these commands:

▶︎ Quick Open Integration

In OmniFocus 4, you can now use “Quick Open” to locate, select, and launch installed Omni Automation plug-ins.

Video 9: Launch Plug-Ins with Quick Open
Example: Create “Jump Link” to Folder