by KryDos

The Linux wrapper for Todoist web version

630 Stars 50 Forks Last release: 4 months ago (1.23.0) MIT License 147 Commits 24 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Todoist Linux (Unofficial)

This app is just an Electron wrapper for Todoist's web version.

This app works with both Windows and Linux.

Link to Official Linux app

Doist recently released the official app as a Snap package. Visit this page to install the Official Todoist app.


Arch Linux (Thanks to HadiLatifi)

The package is available in AUR. You can install it with

trizen -S todoist-electron

Gentoo Linux

To emerge ebuild in first you should add this overlay to

, sync and after it you'll be able to do it. P.S. The original version of the ebuild was taken from here, but unfortunately it's for the old version and i've modified it a bit for the newer version.

NOTE: for security issues, i recommend you mask all packages (

) and unamsk only

Other systems

  1. Go to Releases page and get the RPM/DEB/EXE package.

  2. Most of the time, a simple double-click on the downloaded package should start its installation (use shell commands otherwise).

Alternatively, you can also download the
package from Releases page that can run on any Linux distro.

Keyboard Shortcuts

  • Ctrl+Alt+A - Quickly add a Task
  • Ctrl+Alt+Q - Show or Hide Todoist window
  • Ctrl+Alt+R - Refresh Todoist window content
  • Alt+F4 - Quit Todoist
  • F11 - Toggle Full-screen view

  • Any other possible shortcuts are available and usable directly from within the app itself.

Global shortcuts are configurable via

file (which is located in
by default). The file is simple JSON with descriptive keys and values that represents shortcuts and their keybindings.

Use this page from Electron docs to get a better understanding of what other modifiers (keys) exist that you can use.

Additional Configuration

Same config file

has other options to configure the app:
  • tray-icon
    - tray icon to use. Possible options:
    (to hide tray icon completely)


The main reason I don't like having the Todoist web version opened is that I can't easily ALT+TAB to it.

And I also really wanted to have global keyboard shortcuts so I can quickly add a task to Todoist.

The initial inspiration I took from this brilliant project of the same web version. Unfortunately, it doesn't seem to be maintained anymore and has some issues with Tray functionality on latest Ubuntu.

Build Instructions

The build process is very simple:

  1. Clone the repo using

    $ git clone
  2. Ensure NPM is installed with

    $ apt-get install npm
  3. Install other project dependencies by running

    $ make env
    in project root directory.
  4. Now, to run the app, you can do

    $ make up
    in the project root directory (or
    $ npm run start
    in the

Building Packages

After making your changes, you can simply use any of the below commands to build 64-bit distribution packages.

  1. Run
    $ make build-rpm
    to build
    packages (for Fedora/CentOS/RHEL/SuSE).
  2. Run
    $ make build-deb
    to build
    packages (for Debian/Ubuntu and derivatives).
  3. Run
    $ make build-pacman
    to build
    packages (for Arch/Manjaro and derivatives).
  4. Run
    $ make build-win
    to build Windows
  5. Run
    $ make build-linux
    to build both
  6. Run
    $ make build-all
    to build packages for both Windows and Linux (basically all the above).


No rules for contributing. Just send a pull request :)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.