Support

Product: Task Keys for Todoist (Stream Deck plugin for Windows) · Provider: GRAMSHIFT (Tokyo, Japan)

Product page: Task Keys for Todoist · Buy it from GRAMSHIFT

Contact

If something does not work, email contact@gramshift.com in English or Japanese and we will gladly help. We reply within 7 business days, usually sooner. Please include your Windows version, your Stream Deck app version, the filter of the key, and a screenshot of the key and of its settings: the Status line says what happened. Please never send us your API token, and cover task names in screenshots if you like.

Get started

Open the downloaded .streamDeckPlugin file to install the plugin.
Select a Task Keys key, paste your license key in its settings and choose Activate.
In the Stream Deck app, find Task Keys for Todoist in the action list and drag Next Task, Task Count, Add Task or Daily Goal onto a key. Next Task also goes on a Stream Deck + dial.
In the key's settings, press Open the token page in Todoist. There, under Settings > Integrations > Developer, copy your API token and paste it in the API token field. The token is shared by every key of the plugin, so you paste it only once.
Type a Filter, or leave it empty for today and overdue (the same tasks as the Today view). The key shows the tasks right away.

The actions

Next Task: the first task of the filter, with a band in its priority color and when it is due (orange when a timed task is less than an hour away, red when it is late). A press shows the next task; after the last one, the first again. Hold for 0.6 seconds to complete the task in Todoist. For 5 seconds the key then shows Undo, and a press brings the task back: its subtasks open again too, and a recurring task goes back to the date it had. Order: Todoist's order, priority (p1 first) or due date (soonest first).
Next Task on a Stream Deck + dial: the task name and its date on the touch strip. Turn the dial for the next task, push it to complete the task, push or tap the screen during Undo to bring it back.
Task Count: how many tasks the filter has. The key turns red when one of them is overdue and green when the list is empty. A press opens Todoist in your browser: the Today view for the default filter, a search for any other filter.
Add Task: a press adds the text in Task to add with Todoist's quick add, so dates in words (today, tomorrow at 3pm), p1 to p4, @label and #Project work. The key then shows a tick and the date the task got. With no text, a press opens Todoist.
Daily Goal: the tasks you completed today and your daily goal in Todoist, as a ring that turns green when the goal is met. A press reads them again.

Filters are written the way Todoist filters are written: today | overdue, p1, #Work, @phone, 7 days. Keys with the same filter share one read. The keys read Todoist every minute and right after a task is completed or added, so changes made in the Todoist app show within about a minute.

What the keys show

Key	What happened	What to do
Enter license key	The plugin is not activated on this PC yet.	Paste your license key in a key's settings and choose Activate.
`Token`, "Set in settings"	No API token yet.	Paste your Todoist API token in the key's settings (steps above).
"…"	The plugin is reading Todoist.	Wait a second or two.
`All clear`	The filter has no task.	Nothing to do.
`Check token`, "Todoist said no"	Todoist did not accept the token, for example because it was reset in Todoist.	Copy the token again from Todoist and paste it. The plugin does not try a refused token again and again by itself.
`Check filter`, "Todoist can't read it"	Todoist cannot read the key's filter.	Write it as in Todoist's own filters, or leave it empty.
`Busy`, "Retrying soon"	Todoist asked to wait because of too many requests.	Nothing: the plugin waits and reads again by itself.
`Offline`, `No answer` or `Error`	Todoist could not be reached, did not answer, or answered with an error. A key that had a list keeps it, in grey.	Check that the PC is online. The plugin tries again by itself.
`No answer`, "Check Todoist first" (Add Task)	Todoist did not answer while adding the task, so it may have been added all the same.	Look in Todoist before you press again, so the task is not added twice.
`Task gone`, "Deleted in Todoist"	The task was deleted in Todoist before you completed or brought it back.	Nothing: the next read shows the list as it is now.

The token field in the settings does not save text that is not written like a Todoist API token (letters and digits only) and says so under the field.

Questions

Can a short press complete a task by mistake?

No. A short press only shows the next task. A task is completed only by a hold of 0.6 seconds, and for 5 seconds a press brings it back.

Can the plugin delete my tasks?

No. It completes a task only when you hold a key, adds a task only when you press Add Task, and brings a task back only when you press during Undo. Nothing is ever deleted.

Add Task put the task on the wrong date.

Quick add reads dates in the language set in Todoist. With Todoist in Japanese, write the date in Japanese (for example 明日 for tomorrow).

The count is different from Todoist.

Check that the key's filter is the same as the list you compare with. An empty filter means today | overdue, the same tasks as the Today view. The keys catch up with changes made in Todoist within about a minute.

Does it work on a Mac?

No. The plugin is made for Windows 10 and 11, with Stream Deck 6.9 or later.

On how many PCs can I use it?

One license key works on up to 3 of your own PCs. New versions download from your license key page. If the license key is not accepted, email contact@gramshift.com with your order number.

Which languages are there?

English and Japanese. The keys and the settings are in Japanese when the Stream Deck app is, and in English otherwise.

Privacy

Your API token stays in the Stream Deck app's settings on your PC and is sent only to Todoist, over an encrypted connection. Your tasks and your token are never sent to us; the plugin only checks its license key with our server. See the Privacy Policy.

Task Keys for Todoist is not created by, affiliated with, or supported by Doist or Todoist. Todoist is a trademark of Doist.