On iOS, some applications contain URL schemes. URL schemes are links that launch the application and kickstart extra functionality, sometimes for automating common tasks. In OmniFocus they do a few things: launch directly into a particular view, like Forecast, or add new Stuff from other applications. OmniFocus’s URL Scheme got a major update with OmniFocus for iOS 2.14.
Automating Task Creation in OmniFocus
There are several ways to add actions to your database in iOS—we talk about a few of them on our 3rd party app page—but a lot is possible now.
Let’s start with this simple URL:
We’ve added a basic action to OmniFocus by using these variables:
name(your action’s name)
note(an optional note)
That link will work anywhere OmniFocus is installed. The app will launch from Safari, Mail, or wherever else. But a lot more can be done with new parameters recently introduced in OmniFocus 2.14. (But not yet in OmniFocus for Mac.)
New parameters for the
attachment-name(repeated if necessary for multiple files)
parallel(true or false)
flag(true or false)
defer(date and time, like
jun 25 8am)
due(date and time, like
jun 25 8am)
autocomplete(true or false; do children mark project complete?)
estimate(30m for 30 minutes)
reveal-new-item(true or false)
repeat-rule(see here for more)
repeat method(fixed, start-after-completion, or due-after-completion)
completed(date and time, like
jun 25 6pm)
And if you’re using an app that supports
callback (Workflow, for example) the callback will include a link back to the created task or parent project.
Note: Workflow is currently working on enhanced OmniFocus integration. Stay tuned!
Adding new TaskPaper text
In addition to the
add action, OmniFocus now uses the TaskPaper format for action interchange. This can be leveraged by using the
/paste action in OmniFocus’s URL scheme, performing a long tap on an action or project in a list and selecting paste, or to get data out in the Taskpaper format, selecting Copy from the Share Sheet.
Copy TaskPaper-formatted text from any other app, paste it where you’d like it in OmniFocus, and bam—you’ve got all of your data. Ken, our CEO, put together this Editorial workflow that takes the currently-selected text in Editorial (with placeholders for Template-specific data) and shuttles it over to OmniFocus, perfectly formatted.
Paste has a few extra parameters that can direct the data to a specific spot:
index(positive integers count forward from beginning, while negative #s count back from the end of list)
content(taskpaper string, the content to paste)
If simply activating
omnifocus:///paste without any of the above, the clipboard will be parsed and added to your Inbox.
For the most part, OmniFocus lines up with TaskPaper tags. The full gamut of tags that can be used are discussed in this forum thread near the end.
When adding attachments to new actions, they need to be encoded in Base64. This is easy with Workflow. This shared Workflow takes a file, encodes it, and then sends it over to OmniFocus.
It’s a great way to file a PDF away for review from Mail.
Launching directly into Perspectives
Take this scenario:
Each day, Amanda starts a quick review. It helps her prepare for the urgent and hope-to-do tasks. The bulk of this review occurs with the help of an OmniOutliner document on her iPad Pro. In the Outliner document are specific tasks to perform: some in Mail, OmniFocus, and elsewhere.
The Outliner document is a checklist for the daily review but, additionally, also a launchpad. This is where Amanda quickly jumps around by using the URL scheme: she gains focus and saves time by jumping right where she needs to go.
So Amanda stores a few of these URLS in her OmniOutliner document:
For Pro users, custom perspectives work as well. Instead of placing the custom perspective’s title right after
Handling spaces: make sure you’ve added the HTML entity
%20 as a substition for each space!
Launching to Forecast: Past, Today, Soon
You also have direct access to Forecast cells:
If you don’t need specificity, use
*A note on the
omnifocus:///today link: if the Today setting has been changed in OmniFocus Settings, you’ll head there!