forked from mirrors/autodoist
54 lines
2.3 KiB
Markdown
54 lines
2.3 KiB
Markdown
NextAction
|
|
==========
|
|
|
|
A more GTD-like workflow for Todoist. Uses the REST API to add and remove a `@next_action` label from tasks.
|
|
|
|
This program looks at every list in your Todoist account.
|
|
Any list that ends with `-` or `=` is treated specially, and processed by NextAction.
|
|
|
|
Note that NextAction requires Todoist Premium to function properly, as labels are a premium feature.
|
|
|
|
Requirements
|
|
============
|
|
|
|
* Python 2.7, Python 3.0+ is unsupported at the moment
|
|
* ```todoist-python``` package.
|
|
|
|
Activating NextAction
|
|
=====================
|
|
|
|
Sequential list processing
|
|
--------------------------
|
|
If a list ends with `-`, the top level of tasks will be treated as a priority queue and the most important will be labeled `@next_action`.
|
|
Importance is determined by order in the list
|
|
|
|
Parallel list processing
|
|
------------------------
|
|
If a list name ends with `=`, the top level of tasks will be treated as parallel `@next_action`s.
|
|
The waterfall processing will be applied the same way as sequential lists - every parent task will be treated as sequential. This can be overridden by appending `=` to the name of the parent task.
|
|
|
|
Executing NextAction
|
|
====================
|
|
|
|
You can run NexAction from any system that supports Python, and also deploy to Heroku as a constant running service
|
|
|
|
Running NextAction
|
|
------------------
|
|
|
|
NextAction will read your environment to retrieve your Todoist API key, so to run on a Linux/Mac OSX you can use the following commandline
|
|
|
|
TODOIST_API_KEY="XYZ" python nextaction.py
|
|
|
|
Heroku Support
|
|
--------------
|
|
|
|
[](https://heroku.com/deploy)
|
|
|
|
This package is ready to be pushed to a Heroku instance with minimal configuration values:
|
|
|
|
* ```TODOIST_API_KEY``` - Your Todoist API Key
|
|
* ```TODOIST_NEXT_ACTION_LABEL``` - The label to use in Todoist for next actions (defaults to next_action)
|
|
* ```TODOIST_SYNC_DELAY``` - The number of seconds to wait between syncs. (defaults to 5)
|
|
* ```TODOIST_INBOX_HANDLING``` - What method to use for the Inbox, sequence or parallel (defaults to parallel)
|
|
* ```TODODIST_PARALLEL_SUFFIX``` - What sequence of characters to use to identify parallel processed projects (defaults to =)
|
|
* ```TODODIST_SERIAL_SUFFIX``` - What sequence of characters to use to identify serial processed projects (defaults to -) |