Update README.md

master
Hoffelhas 2020-05-21 19:06:31 +02:00 committed by GitHub
parent f1fc145157
commit e38409eac1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 13 additions and 21 deletions

View File

@ -1,5 +1,4 @@
Autodoist
==========
# Autodoist
This program adds two major functionalities to Todoist to help automate your workflow:
@ -12,58 +11,52 @@ If this tool helped you out, I would really appreciate your support by providing
<img src="https://i.imgur.com/MU1rAPG.png" width="150">
</a>
Requirements
============
# Requirements
* Python 3.8
* ```todoist-python``` package.
Automatic next action labels
=====================
# Automatic next action labels
The program looks for pre-defined tags in the name of every project and parentless tasks in your Todoist account to automatically add and remove `@next_action` labels.
Projects and parentless tasks can be tagged independently from each other to create the required functionality. If this tag is not defined, it will not activate this functionality. The result will be a clear, current and comprehensive list of next actions without the need for further thought.
Make sure the label exists in your Todoist before running the program. Todoist Premium is required in order to use labels and to make this functionality possible.
Make sure the label ```next_action``` exists in your Todoist before running the program. The default label can be changed, see the example at section [Additional Arguments](#additional-arguments) below. Todoist Premium is required in order to use labels and to make this functionality possible.
Sequential list processing
--------------------------
## Sequential list processing
If a project or parentless task ends with `--`, the sub-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.
![Serial task](https://i.imgur.com/SUkhPiE.gif)
Parallel list processing
------------------------
## Parallel list processing
If a project or parentless task name ends with `//`, the sub-tasks will be treated as parallel `@next_action`s.
A waterfall processing is applied, where the lowest possible sub-tasks are labelled.
![Parallel task](https://i.imgur.com/NPTLQ8B.gif)
Parentless tasks
------------------------
## Parentless tasks
Any parentless task can be be given a type by appending `//` or `--` to the name of the task. This works if there is no project type, and will override a previously defined project type.
[See example 1 with a parallel project](https://i.imgur.com/d9Qfq0v.gif)
[See example 2 with a serial project](https://i.imgur.com/JfaAOzZ.gif)
Recurring lists
====================
# Recurring lists
The program looks for all parentless tasks with a recurring date. If they contain sub-tasks, they will be restored in the same order when the parentless task is checked. Todoist Premium is not required for this functionality.
![See example](https://i.imgur.com/WKKd14o.gif)
Executing Autodoist
====================
# Executing Autodoist
You can run Autodoist from any system that supports Python.
Running Autodoist
------------------
## Running Autodoist
Autodoist will read your environment to retrieve your Todoist API key, so to run on Windows/Linux/Mac OSX you can use the following commandline:
@ -73,8 +66,7 @@ If you want to enable recurring re-use mode, run with the `-r` argument:
python autodoist.py -a <API Key> -r
Additional arguments
------------------
## Additional arguments
Several arguments can be provided, for example to change the default label: