5 months ago
5 months ago
5 months ago
preconfiguration set to „UNCONFIGURED“ for an Action
11 months ago
release of the Action Group version 1.0 :)
11 months ago
11 months ago
removed unecessary steps
11 months ago
Draftist Action Group Instructions
created by @FlohGro
- Website: flohgro.com
- Drafts Forums: @FlohGro
- Twitter: @FlohGro
Welcome to Draftist - an Action Group for Draft to integrate with Todoist. This might be the most advanced Action Group to use Drafts with Todoist so please read the instructions.
Before running any other Action, you have to run the “Draftist Setup/Update” Action which downloads the latest version of Draftist from the repository
Draftist contains a big amount of Actions to integrate Drafts with Todoist.
The Actions are divided into the following sections:
- Quick Add Tasks
- Create Single Task
- Create (cross)Linked Task From Draft
- Create Multiple Tasks
- Create Tasks from MD Tasks in Draft
- Import Tasks
- Modify Tasks
Before running any Action in this Action Group, make sure to Setup the
Draftist.js file in your directory by running the
Draftist Setup/Update Action.
Since Draftist contains a lot of Actions and you may not need every single of them you may want to create your own
my Draftist Action Group to only include the Actions you want.
While you can duplicate / move the Actions you use to your own Action Group(s) I recommend to leave the Draftist Action Group untouched. This ensures a single point of truth and if I need to fix/maintain Actions in Draftist your own Actions will work afterwards. Instead you can use the
Draftist Action Replicator Action to reinstall an existing Draftist Action to your
my Draftist Action Group. When you replicated a Draftist Action you can then give your own action a (shorter) name than in the Draftist Action Group (especially on mobile devices the names of some actions are too long to distinguish them easily.).
This is also useful if you want to use Actions with configuration options (to e.g. retrieve tasks from a filter) with different configurations. Then you can use the
Draftist Action Replicator to replicate the same Action from Draftist several times and configure them to your needs.
You can assign keyboard shortcuts to the Actions you created to make them easily accessible (none of the Actions in Draftist has a keyboard shortcut assigned to don’t conflict with your assignments).
Please never rename the
Draftist Action at the top of the Action Group (If you do so, no other Action will work anymore).
Draftist is not displayed as Action Bar (over the keyboard) by default since (again) it contains a lot of Actions which sometimes use the same icons. If you want access to the Actions in the Action Bar - again i recommend to replicate the subset of Draftist Actions you need into your own Action Group and then display these Actions in the Action Bar.
Every Draftist Action contains a short description about its purpose / what it does. Due to the big amount of Actions you can also read through all descriptions in the Action Descriptions file.
All Draftist Actions work out of the box with no needed configuration from you. Especially the more complex and powerful actions allow you to configure the behavior of them in the action steps. Read through the corresponding Action Description to find instructions what and how you can configure the Action to your need.
Draftist is completely free to use for you. However if this Action Group is useful for you and supports your workflows you can give something back to support development.
I enjoy a good coffee ☕️ (weather at home or in an actual coffee shop) and love pizza 🍕.
You can choose the amount you want to donate on those platforms.
Feature Requests and Issue Reporting
If you encounter any issues or have additional feature requests you can reach out to me in different ways:
- report / request issues in the GitHub repository here
- take part in the conversation in the Drafts forums here
- contact me on other platforms of your choice here
Draftist will create three new files in your iCloud Drive folder at the path
DraftistDataStore.json: Draftist Todoist Data Store
- this file stores data from your Todoist account which is used by several actions
- the data includes:
- projects (and their metadata)
- sections (and their metadata)
- labels (and their metadata)
- none of this data leaves your iCloud Account, it is synced in the Drafts directory - it’s just used to not always request the data from Todoists API which slows down the process of e.g. creating tasks with settings a lot.
DraftistSettings.json: Draftist Action Group Settings
- this file stores the settings you can modify with the Draftist Settings Action
Draftist.js: Draftist Functions
- this file contains the functions all the Draftist Actions use under the hood. This enables the update process without the need to reinstall the complete Action Group.
I don’t recommend to delete these files unless you have issues using Draftist. If you delete the
Draftist.js no Action in the Draftist Action Group will work anymore until you reinstall the file. The Settings and Data Store file will be recreated automatically.
To stay up to date on new updates you can follow me on Twitter or take part in the converstaion in the Drafts forums post
You can find a changelog of updates to Action Group in the Changelog section of the README in this repository.
Draftist Action Replicator
update local Todoist data
Quick Add Tasks
quick add lines from draft
quick add lines from prompt
Create Single Task
task with description from draft
task with description from prompt
task with description & settings from draft
task with description & settings from prompt
Create (cross)Linked Task From Draft
create linked task in inbox
create linked task with settings
create crosslinked task in inbox
create crosslinked task with settings
Create Multiple Tasks
tasks with same settings from draft
tasks with same settings from prompt
tasks with individual settings from draft
tasks with individual settings from prompt
Create Tasks from MD Tasks in Draft
quick add tasks from md tasks in draft
tasks with same settings from md tasks in draft
tasks with individual settings from md tasks in draft
import todays tasks
import tasks from project
import tasks from selected project
import tasks with all configured label(s)
import tasks with any configured label(s)
import tasks with all selected label(s)
import tasks with any selected label(s) configured
import tasks from filter
import tasks from filter in prompt
update labels of selected tasks from filter
duplicate selected tasks with other label
update individual due date of selected task from filter
update due date of selected task from filter to same date
resolve selected tasks from filter
delete selected tasks from filter