Package: todo-txt-tui
TodoTxtTUIA 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.FeaturesKeybindingsConfigurationThemeInstallationHow to updateUsageTodo.txt explainedFeaturesPriorities: 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. Seedetails.Recurring tasks: Tasks can have a recurrence pattern, automatically creating new tasks upon completion. For examplerec:1dorrec:+1y.Projects/Contexts: With autosuggestions and autocompletion.Search: Quickly find the tasks you're looking for.Archiving: Completed tasks can be moved todone.txt.Completion/Creation dates: Can be enabled or disabled in settingsMarkdown 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: YesHidden tasks: Default visibility can be set in settings and toggled withtMuch more...Keybindingsj/down: Move cursor downk/up: Move cursor upgg: Go top of listG: Go to bottom of listn: Add new task (enterto save,escto dismiss)e: Edit existing task (enterto save,escto dismiss)tab: Autocomplete suggested projects and contextsE: Edit existing task, but place cursor at the end oftask text componentinstead of end of entire taskx: Toggle task complete/incompleteX: Complete and archive task immediatelyA: Archive completed tasks to done.txtD: Delete taskP: Postpone task (set due date tomorrow if task has existing due date)f: Focus search field (enterto focus task list)r: Reset search/Refresh task listu: Open URL in focused taskIf task has multiple URLs, pressufollowed by e.g.2to open the second URLUOpen all URLs in taskSHIFT + [1-9]: Display only tasks with priority A, B, C, D, E, F, G, H or ISHIFT + 0: Reset displayt: Toggle visibility of tasks with threshold in futureh: Toggle visibility of hidden tasksq: Quit applicationConfigurationThis is optional.Linux:~/.config/todo-txt-tui/settings.confmacOS:~/Library/Application Support/todo-txt-tui/settings.confSettings (default):[["enableCompletionAndCreationDates","true"],["hideCompletionAndCreationDates","true"],["placeCursorBeforeMetadataWhenEditingTasks","false"],["displayHiddenTasksByDefault","false"],["hideTasksWithThresholdDates","true"]]ThemeThis is optional.Linux:~/.config/todo-txt-tui/palette.confmacOS:~/Library/Application Support/todo-txt-tui/palette.confTheme (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.Seesupported colors.InstallationMake sure you have Python installed.pip3 install todo-txt-tuiTroubleshootingMac users may have issues with their Python installation. Seetroubleshooting.How to updateYou will be notified if a new version is available, but you can update manually.pip3 install --upgrade todo-txt-tuiUsagetodo-txt-tui /path/to/todo.txtTip! Create an alias to speed things up. Example:alias todo="todo-txt-tui /path/to/todo.txt". Then you can simply typetodoin your terminal and the app will start and open your preferred todo.txt list.Additional commandstodo-txt-tui --version
todo-txt-tui --helpOriginal ideaRead more attodotxt.org. Gina Trapani originally came up with the idea. It has since been extended, e.g. with recurring tasks and other features.MoreSeehigh level features overviewanddetails.