Inbox for Todoist

An Übersicht widget for your Todoist Inbox

I am currently searching for someone maintaining this software. I haven't used a mac in over two years (as I now switched to linux) and as I see that people are still using this widget, I think a maintainer would come in handy for the community. Feel free to email me at [email protected] if you are interested.

---

About

Inbox for Todoist is a simple Übersicht widget designed to present your todoist inbox on your Desktop. It is in no way affiliated with the Brand Todoist or Doist in any way nor is it affiliated with Übersicht or Felix Hageloh

Below is a preview of what Inbox for Todoist can look like:

In some context with other widgets, your interface could look like this:

Requirements

• Python 3
• Todoist's Python Package

Installing Python 3

From python's web site

Download and install the latest version of python 3 from this website :

https://www.python.org/downloads/mac-osx/

Using homebrew (Recommended)

First install homebrew (if not already installed):

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Then run the following command in a terminal window:

brew install python

Installing Todoist's Python Package

Open a terminal window and type:

pip3 install todoist-python

In some context with other widgets, your interface could look like this:

Installation

Clone this repository to your Übersicht folder:

~/Library/Application Support/Übersicht/widgets/

Setting up your own Todoist Token

The inbox_for_todoist folder contains a file named todoist_API.txt. In that file, replace ___YOUR TODOIST TOKEN HERE:___ with your own token.

You todoist token can be found on Todoist inside of settings and then Integrations. It will be labelled as API Token.

Rest assured that if you submit a pull request, your token will not be shared as todoist_API.txt has been set to be ignored by github inside the .gitignore file line: 108. Also none of your tasks stored inside your offline cache will be shared as todoist.cache has been set to be ignored by github inside the .gitignore file line: 105.

Preferences

Refresh Rate

By default, Inbox for Todoist refreshes every second. To reduce CPU & Memory Usage, you may go to line: 5 of index.coffee and adjust this:

Removing the first	#	will make the widget refresh every	minute.
Removing the second	#	will make the widget refresh every	5 minutes.
Removing the third	#	will make the widget refresh every	10 minutes.
Removing the fourth	#	will make the widget refresh every	20 minutes.
Removing the fifth	#	will make the widget refresh every	hour.
Removing the sixth	#	will make the widget refresh every	12 hours.

Priority Color Coding

You can change the colors of tasks inside of the .coffee file. By default, tasks are colored the same way they are in the todoist mac app in dark. The following line to edit are:

To edit the color of tasks labelled	priority1	edit the	rgba(r, g, b, a)	on line	21
To edit the color of tasks labelled	priority2	edit the	rgba(r, g, b, a)	on line	23
To edit the color of tasks labelled	priority3	edit the	rgba(r, g, b, a)	on line	25
To edit the color of tasks labelled	priority4	edit the	rgba(r, g, b, a)	on line	27

The default color for the widget is rgba(#F2F2F2, 1.0).

Recent Updates

• 2018-11-04 Widget now keeps an offline cache of your tasks
  • No more Error messages when you computer's offline (due to cache)
• 2018-11-04 API keys are stored on a .txt file outside the script. (todoist_API.txt)
• 2018-10-03 Priority color coding Support

Possible Eventual Improvements

(checked items are under developpement)

• Task Sorting
  • Tasks sorted by due date first
  • Task sorted by priority second
• Todoist Markdown Support
• Indent embedded subtasks