/lsi

An interactive viewer for todo-txt.

Primary LanguagePythonMIT LicenseMIT

lsi

An interactive viewer for todo.txt.

Setup on macOS

Install todo-txt:

brew install todo-txt

Then, configure your TODO_DIR by editing the config file in ~/.todo/config.

To install this extension:

cd ~/.todo.actions.d
git clone https://github.com/aengl/lsi.git

If the directory doesn't exist, create it manually first.

Optionally, the watchdog package needs to be installed (only if the -w flag is used).

pip3 install watchdog

If you're using iTerm, don't forget to install shell integration and refer to this issue for touch scrolling.

Usage

Run the interactive viewer with:

todo.sh lsi

Keyboard shortcuts

  • j/k/up/down: navigate items
  • home/end: scroll to top/bottom
  • q/esc: cancel filter or quit
  • r: refresh
  • e: edit todo.txt file (requires edit add-on)
  • /: start filtering
  • d: mark item as done
  • n: navigate to the URL in an item (requires nav add-on)
  • space/return: enter dialog (doesn't have much of a point right now and might get removed soon)
  • -/=: increase/decrease item priority
  • A-Z: set item priority
  • 0: unset item priority

Command line arguments

  • You can pass an optional positional argument that will apply an initial filter.
  • -s/--simple: Enters simple mode for terminals that don't support defining custom colors. Terminal on macOS will need this, as will Hyper, but iTerm will work fine without it.
  • -m/--mouse: Experimental mouse support. Not recommended.
  • -w/--watch: Watches the todo.txt for changes and respond to changes in real-time.