kdheepak/taskwarrior-tui
1
0
Fork 0
mirror of https://github.com/kdheepak/taskwarrior-tui.git synced 2025-08-25 08:47:18 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions
taskwarrior-tui: A terminal user interface for taskwarrior kdheepak.com/taskwarrior-tui https://kdheepak.com/taskwarrior-tui
238 commits 6 branches 162 tags 3.1 MiB
Find a file
Dheepak Krishnamurthy a6ab282442 Make some cargo clippy changes
2020-10-22 21:52:00 -06:00
.github/workflows Remove publish to cargo step 2020-08-07 01:18:20 -06:00
src Make some cargo clippy changes 2020-10-22 21:52:00 -06:00
.env Add .env 2020-07-27 00:39:37 -06:00
.gitignore Add tests/data to .gitignore 2020-07-27 00:38:56 -06:00
.rustfmt.toml Autoformat code 2020-10-10 21:34:04 -06:00
Cargo.lock Bump to v0.7.3 2020-10-20 17:04:58 -06:00
Cargo.toml Bump to v0.7.3 2020-10-20 17:04:58 -06:00
LICENSE Initial commit 2020-07-26 15:35:39 -06:00
README.md Update README.md 2020-10-21 01:59:02 -06:00

README.md

Taskwarrior TUI

CI

A Terminal User Interface for Taskwarrior.

taskwarrior-tui

Installation

You will need to install taskwarrior first. See https://taskwarrior.org/download/ for more information.

Manual

  1. Download the tar.gz file for your OS from the latest release.
  2. Unzip the tar.gz file
  3. Run with ./taskwarrior-tui.

Using zdharma/zinit

Add the following to your ~/.zshrc:

zinit ice wait:2 lucid extract"" from"gh-r" as"command" mv"taskwarrior-tui* -> tt"
zinit load kdheepak/taskwarrior-tui

Using cargo

git clone https://github.com/kdheepak/taskwarrior-tui.git
cd taskwarrior-tui
cargo build --release

Using AUR

Use your favorite installation method to download the AUR package maintained by @loki7990.

Usage

Easy to use interface:

Click to expand!
  • /: task {string} - Filter task report
  • a: task add {string} - Add new task
  • d: task {selected} done - Mark task as done
  • e: task {selected} edit - Open selected task in editor
  • j: {selected+=1} - Move down in task report
  • k: {selected-=1} - Move up in task report
  • l: task log {string} - Log new task
  • m: task {selected} modify {string} - Modify selected task
  • q: exit - Quit
  • s: task {selected} start/stop - Toggle start and stop
  • u: task undo - Undo
  • x: task delete {selected} - Delete
  • A: task {selected} annotate {string} - Annotate current task
  • ?: help - Help menu
  • !: {string} - Custom shell command

taskwarrior-tui

readline-like functionality:

Click to expand!
  • <Ctrl-a> : Go to beginning of the line
  • <Ctrl-e> : Go to end of the line
  • <Ctrl-u> : Delete from beginning of the line
  • <Ctrl-k> : Delete to end of the line
  • <Ctrl-w> : Delete previous word

taskwarrior-tui

Configure taskwarrior-tui using ~/.taskrc:

Click to expand!

taskwarrior-tui reads values from your taskwarrior's taskrc file (default: ~/.taskrc).

For example, color.active is used to style the active task. If you would like to try it, open your taskrc file and change color.active=white on blue.

So color.active will take precedence over color.overdue. You can see what color.active is by running task show color.active in your favorite shell prompt.

The following color attributes are supported:

color.deleted
color.completed
color.active
color.overdue
color.scheduled
color.due.today
color.due
color.blocked
color.blocking
color.recurring
color.tagged

Other taskwarrior-tui configuration options are possible using the user defined attribute feature of taskwarrior. All taskwarrior-tui specific configuration options will begin with uda.taskwarrior-tui.. The following is a full list of all the options available and their default values implemented by taskwarrior-tui if not defined in your taskrc file.

uda.taskwarrior-tui.selection.indicator=•
uda.taskwarrior-tui.selection.bold=yes
uda.taskwarrior-tui.selection.italic=no
uda.taskwarrior-tui.selection.dim=no
uda.taskwarrior-tui.selection.blink=no