TodoTxtTUI

A powerful, keyboard-driven terminal application for managing todo.txt files.

Supports Linux and macOS. In theory, it should work on Windows, but I currently have no plans on testing this.

• Features
• Keybindings
• Configuration
• Theme
• Installation
  • How to update
• Usage
• Todo.txt explained

Features

• Priorities: Tasks can have priorities and are color-coded accordingly.
• Sorting: Tasks sorted by due date, priority and alphabetical (in that order).
• Due Dates: Tasks can have due dates and are grouped by them.
  • Natural Language Processing (NLP): For example, due:tomorrow.
• Threshold Dates: Also known as deferred tasks. See details.
• Recurring tasks: Tasks can have a recurrence pattern, automatically creating new tasks upon completion. For example rec:1d or rec:+1y.
• Projects/Contexts: With autosuggestions and autocompletion.
• Search: Quickly find the tasks you're looking for.
• Archiving: Completed tasks can be moved to done.txt.
• Completion/Creation dates: Can be enabled or disabled in settings
• Markdown links: Yes.
• Sync: Changes made in todo.txt outside the application will be reflected in the app.
• Keyboard driven: Navigate and manipulate everything from your keyboard with vim-inspired keys.
• Custom themes: Yes
• Hidden tasks: Default visibility can be set in settings and toggled with t
• Much more...

Keybindings

• j/down: Move cursor down
• k/up: Move cursor up
• gg: Go top of list
• G: Go to bottom of list
• n: Add new task (enter to save, esc to dismiss)
• e: Edit existing task (enter to save, esc to dismiss)
  • tab: Autocomplete suggested projects and contexts
• E: Edit existing task, but place cursor at the end of task text component instead of end of entire task
• x: Toggle task complete/incomplete
• X: Complete and archive task immediately
• A: Archive completed tasks to done.txt
• D: Delete task
• P: Postpone task (set due date tomorrow if task has existing due date)
• f: Focus search field (enter to focus task list)
• r: Reset search/Refresh task list
• u: Open URL in focused task
  • If task has multiple URLs, press u followed by e.g. 2 to open the second URL
  • U Open all URLs in task
• SHIFT + [1-9]: Display only tasks with priority A, B, C, D, E, F, G, H or I
  • SHIFT + 0: Reset display
• t: Toggle visibility of tasks with threshold in future
• h: Toggle visibility of hidden tasks
• q: Quit application

Configuration

This is optional.

• Linux: ~/.config/todo-txt-tui/settings.conf
• macOS: ~/Library/Application Support/todo-txt-tui/settings.conf

Settings (default):

[
    ["enableCompletionAndCreationDates", "true"],
    ["hideCompletionAndCreationDates", "true"], 
    ["placeCursorBeforeMetadataWhenEditingTasks", "false"],
    ["displayHiddenTasksByDefault", "false"],
    ["hideTasksWithThresholdDates", "true"]
]

Theme

This is optional.

• Linux: ~/.config/todo-txt-tui/palette.conf
• macOS: ~/Library/Application Support/todo-txt-tui/palette.conf

Theme (default):

[
    ["bold", "bold", ""],
    ["text", "", ""],
    ["priority_a", "light red", ""],
    ["priority_b", "brown", ""],
    ["priority_c", "light green", ""],
    ["priority_d", "light blue", ""],
    ["priority_e", "dark magenta", ""],
    ["context", "light magenta", ""],
    ["project", "yellow", ""],
    ["is_complete", "dark gray", ""],
    ["is_danger", "light red", ""],
    ["is_success", "light green", ""],
    ["is_link", "light blue", ""],
    ["heading_overdue", "light red,italics,bold", ""],
    ["heading_today", "light green,italics,bold", ""],
    ["heading_future", "default,italics,bold", ""]
]

Light theme:

The dark theme above should work just fine (text color and background adjusts to your terminal). You may however, want to change project color to e.g. ["project", "dark cyan", ""] since yellow on white can be hard to read.

See supported colors.

Installation

Make sure you have Python installed.

pip3 install todo-txt-tui

How to update

You will be notified if a new version is available, but you can update manually.

pip3 install --upgrade todo-txt-tui

Usage

todo-txt-tui /path/to/todo.txt

Tip! Create an alias to speed things up. Example: alias todo="todo-txt-tui /path/to/todo.txt". Then you can simply type todo in your terminal and the app will start and open your preferred todo.txt list.

Additional commands

todo-txt-tui --version
todo-txt-tui --help

---

Original idea
Read more at todotxt.org. Gina Trapani originally came up with the idea. It has since been extended, e.g. with recurring tasks and other features.

More
See high level features overview and details.