Repository files navigation

This script uses theofficial Todoist API to indicate the number of tasks of each priority level.

By default, only tasks with a set 'due date' which is equal to the current date are taken into account. (But you can easily change that; for example, I personally use the filtertoday | overdue | no date.)

The same module is available for waybarhere.

0. Downloadpolybar-todoist.py from this repo.
1. Install theofficial Todoist Python Module. (e.g. withpip install todoist-api-python)
2. Configure the API Token retrieval.
3. Copy-paste the following example configuration into your polybar config:

   [module/todoist]type = custom/scriptexec = python -u /path/to/polybar-todoist.pytail = trueclick-left = xdg-open https://todoist.com

To get your Todoist tasks, the python module uses theTodoist API. This requires an API Token.You can get one in theTodoist Integrations Settings. (Todoist -> Settings -> Integrations)

Now the tricky part is how thepolybar-todoist.py script gets access to your API token. For this, the script implements aapi_token() function.You are required to implement this method, such that it returns your API token.

The simplest way would be to hard-code it into the script (i.e.return <YOUR_API_TOKEN>), but I don't recommend this.Rather, query it from your password manager / keyring, or read it from an external file.

By default, it asksGNOME Keyring for a password with the uuidtodoist_api_token. So if you use GNOME Keyring anyway, you can just execute

secret-tool store --label='Todoist API Token' uuid todoist_api_token

and type in your API Token. Then it works out of the box.

The code is very short and simple. You can easily customize output style, task filter, and so on.