Installation

• Install from PyPI: pip3 install –user simplegtd

• Install as RPM: download / unpack the source and run python3 setup.py bdist_rpm in the source-unpacked folder, then install the RPM from the dist/ folder.

• Install on your system: download / unpack the source and run python3 setup.py install in the source-unpacked folder.

• Run directly from the source: download / unpack the source and run bin/simplegtd from the source-unpacked folder.

All methods work equally well, but only the RPM installation method is guaranteed to install a desktop menu icon for the application.

Usage

The application is fairly simple to use. When you start it, an empty window will pop up. Click on the Help icon in the header bar to see the shortcut keys you can use to manage your tasks. The standard keyboard shortcuts will work well.

By default, the application will store your todo.txt file in the hidden data directory (on Linux, ~/.local/share/simplegtd/) within your home folder. You can, however, change that – use the header bar Open icon to select / create a to-do file of your choice anywhere you want. Simple GTD will then open a new window with the file. Now close the other window – Simple GTD will now remember which files you have opened.

The application will remember multiple windows with different files open as well. If you quit the application (using Quit in the toolbar or the keyboard combination) instead of closing windows one-by-one, next time you run it, Simple GTD will reopen the files you’d had open first.

Features

Sync-ready and sync-friendly

While Simple GTD does not have any built-in sync features – and has no plans to gain them – it supports any sync tool you want to use, from Git to Syncthing to Dropbox. Incoming changes to your to-do file are reflected in the user interface immediately. The author has verified that syncing todo.txt to and from Simpletask Cloudless works perfectly (using Syncthing as the sync mechanism).

The algorithm used to persist and detect state changes in the to-do file is robust and efficient. When Simple GTD detects external changes to your to-do file, only the portions of the file that changed are reloaded. When you make changes to your to-do file in Simple GTD, Simple GTD saves the changes immediately, letting your sync program do its job right away.

Keyboard- and mouse-friendly

Entering new tasks and managing existing tasks with Simple GTD is quick and easy – a single keystroke to add a task, and a single keystroke to edit an existing task. Most of the standard shortcut keys you’ve learned work exactly as intended.