Todo.txt TUI is a highly customizable terminal-based application for managing your todo tasks. It follows the todo.txt format and offers a wide range of configuration options to suit your needs. Please note that the application may have some bugs as it's still under development, so your feedback and bug reports are greatly appreciated.
Please note that this Todo.txt TUI application is intended for personal use and is not published on Rust's docs.rs or crates.io. Therefore, it must be installed manually.
cargo build --release
Copy the executable from the target directory to a directory included in your system's PATH.
cp target/release/todotxt-tui /usr/local/bin/
Todo.txt TUI provides a straightforward and customizable interface for managing your tasks. The following keybindings and actions are available for basic usage, and please note that these actions can be configured according to your preferences in the configuration file:
j
: Move down in the list.k
: Move up in the list.g
: Go to the first item in the list.G
: Go to the last item in the list.Enter
: Select an item.U
: Swap the selected item up.D
: Swap the selected item down.x
: Remove the selected item.d
: Move a task between the pending and done lists.I
: Input a new task.E
: Edit the selected item.J
: Move to the widget below the current one.K
: Move to the widget above the current one.H
: Move to the widget on the left.L
: Move to the widget on the right.q
: Quit the application.In Todo.txt TUI, you can customize various settings to tailor the application to your preferences.
Todo.txt TUI uses a TOML configuration file located at ~/.config/todo-tui.toml
for customization.
Here's an overview of some of the key settings:
In Todo.txt TUI, you can customize the colors and text styling for various elements. You have the flexibility to set foreground (fg
) and background (bg
) colors, as well as apply text modifiers for styling. Colors can be defined using color names, RGB values, or terminal index.
You can apply text modifiers to change the style of text within Todo.txt TUI. Available text modifiers include:
Bold
: Apply bold styling to the text.Italic
: Apply italic styling to the text.Underlined
: Apply underlined styling to the text.Here's an example of how to configure custom color and text modifiers for project todo-tui
in your Todo.txt TUI application's TOML configuration:
[custom_category_style."+todo-tui"]
fg = [255, 0, 0] # Set foreground color to red using RGB values
bg = "Black" # Set background color to black
modifiers = "Italic" # Apply italic styling
You can specify how tasks are sorted using the pending_sort
and done_sort
options. The available sorting options are:
None
: No specific sorting; tasks appear in the order they were added.Reverse
: Reverse the order of tasks.Priority
: Sort tasks by priority.Alphanumeric
: Sort tasks in alphanumeric order.AlphanumericReverse
: Sort tasks in reverse alphanumeric order.The preview_format
setting allows you to define the format for the task preview. You can use placeholders enclosed in {}
to display task information. Here are the available placeholders and their corresponding values:
{n}
: Number of pending tasks.{N}
: Number of completed tasks.{s}
: Task subject.{p}
: Task priority.{c}
: Task creation date.{f}
: Task finish date.{F}
: Task finished status (true or false).{t}
: Task threshold date.{d}
: Task due date.{C}
: Task contexts.{P}
: Task projects.{H}
: Task hashtags.The layout setting allows you to define a custom layout for the application using blocks []
. You can specify the orientation of the blocks as either Direction: Vertical
or Direction: Horizontal
, along with the size of each block as a percentage or value. Within these blocks, you can include various widgets, such as:
List
: The main list of tasks.Preview
: The task preview section.Done
: The list of completed tasks.Projects
: The list of projects.Contexts
: The list of contexts.Hashtags
: The list of hashtags.Here's an example of a custom layout configuration:
[
Direction: Horizontal,
Size: 50%,
[
List: 50%,
Preview,
],
[ Direction: Vertical,
Done,
[
Contexts,
Projects,
],
],
]
This example creates a layout with a horizontal split, where the list takes up 50% of the width, and the preview occupies the remaining space. On the right side, there's a vertical split with the list of completed tasks, contexts, and projects.
Feel free to adjust these settings to create a Todo.txt TUI interface that suits your workflow and preferences.
As this application is still in development, your feedback is greatly appreciated. If you encounter any issues or have suggestions for improvement, please open an issue on the GitHub repository to assist me in making Todo.txt TUI better.