Drafts Release Notes

Last Updated: 06232022-161252


Drafts updates often. Keep up with the latest additions and fixes below. You can also always get highlights of the latest additions in the app via “What’s New” (Settings on iOS, Help menu on Mac).

32.2

32.1

32.0

r32
r32

What’s New

Action Bar Tint Colors

For those who are fond of using color to distinguish items on screen, there is now an option to use action tint colors in the Action Bar. To enable on iOS, scroll to Action Bar options in Aa editor settings. On Mac, toggle menu item in Action Bar’s group selection drop-down menu.

Date Math - Travel in Time, Sort of…

It is sometimes useful to output a date that is relative to another date (usually the current one), adjusted by some time interval. It has always been possible in script to create and adjust future and past dates, but now it is easier with the addition of a new method to adjust dates using simple date math expressions.

This begins with a new way to create related date expressions, which consist of a list of plus or minus time intervals which can applied to a date. Each expression look like (+|-)(integer) (unit), and can be combined in a list to make multiple adjustments to a date. A couple of quick examples:

Units supported are: year, month, day, hour, minute, second. Units can be used in either singular or plural forms.

These expressions can be used in JavaScripts with the [adjustDate(date, expression) function](https://scripting.getdrafts.com/globals#adjustdate), or by providing an additional expression argument, along with the strftime formatting argument, in template tags which work with date. Those tags are the 2022-06-23, 2022-06-23-16-13-08, [[created]], and 2022-06-23 tags. Again, by example:

Adjustment expressions are calendar-aware, such that adding 1 month to May 31 would result in June 30, since June does not have a 31st.

A couple of ready to use examples:

Mustache Templates

Drafts templates, with their square-bracket, # Drafts Release Notes-style tags are still the default throughout actions, but with this update we have introduced the option to use an alternate template engine based on Mustache templates.

Mustache templates provide some additional power, like the ability to have conditionally rendered blocks, loop over arrays, insert information from other drafts, as well as more powerful filtering options. For details, see the Mustache documentation.

Mustache templates are available as a option on all long-form templates in action steps, can can also be triggered via script using the [draft.processMustacheTemplate function](https://scripting.getdrafts.com/classes/draft#processmustachetemplate).

Using Mustache Templates for Safari Web Capture

If you often capture using the share extension and Safari, you might be interested in switching your web capture template to use Mustache. This has the advantage of being able to use conditional sections to only render part of the text template for the captured text selection if a selection exists.

Improved Template Editing

Drafts now includes basic syntax hightlighting definitions for both Drafts templates, and the new Mustache templates. When editing long-form templates in actions steps, the templates can now (optionally) be opened in an editor with syntax highlighting and basic autocomplete for common tags. Use the edit button by the template in the action editor to open the template editor.

Other Changes and Updates

31.2

31.1

31.0

What’s New

Interface Refresh

Lots of general usability and interface and improvements, including updated icons, some button re-organization, and a variety of new features. Highlights:

Notion Integration (Beta)

This version introduces basic integration with the Notion online project management system. Notion’s API is still in beta but has become stable enough to start offering integration in Drafts. Be aware that aspects of this functionality may change or stop working if Notion makes changes in its API during the development process. We also plan to expand functionality based on feedback, so if you are using Drafts with Notion, please let us know other features you would like to see added.

r31-2
r31-2

This initial integration provides:

For details, example actions, etc., see our Notion Integration Guide.

Maintenance Tasks

New “Maintenance” view in Settings/Preferences. This view is a home for completely optional periodic maintenance tasks to help restore defaults, clean up data you may no longer care about, or improve performance. Make sure you understand what the tasks do before running one because some are destructive and not reversible. Details on available tasks in the User Guide.

Other Changes and Updates

30.1

30.0

What’s New

r30
r30

Transcribe Text from Audio and Video Files

Drafts now registers itself to open most common audio and video formats. If you open an audio or video file in Drafts, you will be prompted with an option to transcribe text using speech recognition. Speech recognition will process the audio in the same way as dictation, so dictation commands for punctuation, etc., are supported.

This is most useful for transcribing the content of single-speaker voice audio, like a voice memo, or recorded lecture, but it will happily attempt to transcribe other forms of audio as well, though the quality of the results may vary.

To try it out:

If you plan to use this transcription, please read the full documentation to understand its capabilities and limitations.

Extract Text from PDFs

If you attempt to open a PDF file in Drafts, you will now be offered the option to extract text from the PDF into a new Drafts.

To try it out:

Extraction will only grab actual text content from the PDF. Some PDF files have embedded image content and will not work with this feature.

Learn more about PDF Text Extraction

Other Changes and Updates

29.1

Bug fix release for a few issues in the inital 29.0 release.

All Platforms

iOS

Mac

29.0

What’s New

Shortcuts for Mac / macOS 12 Support

Drafts provides a wide variety of actions for use in Apple’s automation app, Shortcuts. These can be used for simple things like creating a new draft, opening Drafts directly to specific workspaces – or advanced processing by querying and updating multiple drafts.

r29-4
r29-4

With macOS 12, Apple has brought the power of Shortcuts to the Mac, and Drafts is ready. All Drafts’ Shortcuts actions now work on both iOS and Mac, and shortcuts created using these actions work cross-platform, allowing you to create, modify, and use those shortcuts on all your devices!

Autocomplete

Drafts now includes an extensible system to provide drop-down autocomplete suggestions while typing in the editor. Autocomplete includes a global system for creating and inserting text snippets. Additional autocomplete suggestions can also be provided by syntax definitions.

Global Autcomplete Suggestions

Do you have snippets of text you reuse regularly? Email addresses? Templates? Then autocomplete suggestions will be a handy addition.

r29-3
r29-3

Visit the Autocomplete tab in Editor Preferences (Aa button below editor) to get started configuring your suggestion drop-down items. Set the “Trigger” text to control what sequence of characters will trigger the suggestion drop-down to appear, and add items for frequently used snippets. Suggestions can use Drafts template tags to insert the current date, location, or other values.

Link Completion and Draft Insertion

Drafts built-in Markdown syntaxes (Markdown, GitHub Markdown, and MultiMarkdown) now include two additional autocompletion features to work with other drafts in your library:

r29-2
r29-2

These features are implemented using a new set of configuration options available to all syntax definitions. If you create custom syntax definitions, and would like to add this functionality (or similar) to your custom syntax definitions, take a look at the related documentation on autocomplete in syntaxes

_Learn more about Autocomplete_

Other Updates and Fixes

All Platforms

iOS

28.1

Bug fix release addressing a few issues in release 28:

28.0

What’s New

Ready for iOS 15 and macOS 12

r28
r28

Drafts is ready for iOS 15 and macOS 12! Updated for compatibility, of course, but also to take advantage of some of the great new features. New details below, but Drafts works great with “Live Text” to capture text from images, has full support for Shortcuts on the Mac, and brings great new iPad features, like powerful external keyboard menus.

New Apple Watch App

r28-2
r28-2

We have re-written the Drafts Apple Watch app from the ground up to use the latest watchOS technologies. It’s still the best, easiest way to capture ideas on the go, but has a few new tricks:

Note that you may need to reconfigure your complication options after upgrade, especially if you want auto-capture, which was previously a setting and not based on the complication used.

Learn More About Drafts on Apple Watch →

Shortcuts Support on macOS 12

We’re ready for Shortcuts on the Mac! It’s just not quite ready for us. Look for full, cross-platform support for all of Drafts’ Shortcuts actions when macOS 12 (Monterey) is released in the coming weeks!

In the meantime, enjoy these new shortcut actions on iOS:

Learn More About Shortcuts →

Folder Bookmarks

Up to now, Drafts file actions and scripts have been limited to working with files in the “Drafts” folder in iCloud Drive (or by working directly with cloud-provider APIs, like Dropbox and Google Drive). With folder bookmarks, it is now possible to grant permissions to additional folders outside the Drafts App Sandbox, making it easier to integrate with other apps and services, to, say, export a draft content to another system - like an Obsidian Vault, etc.

Learn More About Bookmarks →

Document Scanning and Live Text Support

Drafts has been tested and works great with the new “Live Text” features in iOS 15 and macOS 12. In addition, we have incorporated document scanning to OCR directly in the iOS app. Tap and hold the “+” and select “Scan Document” to open the document scanning camera. It supports scanning multi-page documents, and directly runs the results through OCR to create a new draft with the result text.

Learn More About Live Text & Scanning →

Share Extension and Capture Window Updates

Drafts capture flow used in the iOS Share extension and the “Capture” window on Mac, has received a number of updates:

Learn more about the iOS Share Extension and Mac Capture Window

General Improvements

Other Updates and Fixes

All Platforms

iOS

Mac

Scripting, Shortcuts, and URL Schemes

27.0

What’s New

Custom Theme Support for Widgets + New Action Icons

It is now possible to select custom light and dark themes for Home Screen (iOS) and Notification Center (macOS) widgets from the built-in and custom themes you have installed in Drafts. To make changes, tap and hold on a widget, select “Edit Widget”, and make changes in the widget configuration.

r27
r27

We have also added dozens of new icons for actions/workspaces in categories like Health, Animals, Education, Email, and more.

If you create custom themes, you may wish to add the following new keys in colors.interface: widgetBackground, widgetBackgroundAlternate, widgetForeground, widgetForegroundAlternate. If not present, these values will fall back to existing related keys: background, backgroundCollection, foreground, so existing themes should work out of the box without updates.

Google Tasks and Microsoft To Do Integration

Extensive integration with two of the most popular task managers: Google Tasks and Microsoft To Do. This version adds new action steps which can create individual tasks, or add each line of draft as a task, to lists in either Google Tasks or Microsoft To Do.

r27-2
r27-2

Both services are available via scripting, with powerful script objects with convenience methods for creating and updated tasks and lists, while also exposing the full APIs to advanced users.

For sample actions and details:

Arrange Mode Improvements

Arrange mode has better external keyboard support, especially on iOS, including: - Esc and ⌘-return to cancel or accept changes - Arrow keys navigate up-down in the list - ⌘-up/down move the selected line up and down in the list.

Other Updates and Fixes

Changelog Archive

Starting with version 27, the iOS and Mac changelogs were merged on this page. For previous release notes, see archives below.

Table of contents

Download on App Store Download on Mac App Store

© 2012-2022 by Agile Tortoise, Inc.
Drafts is a registered Trademark of Agile Tortoise, Inc.
Privacy | Terms