kabmat

TUI program for managing kanban boards with vim-like keybindings

Dependencies

• ncurses for the UI
• make and g++/gcc for compiling and installing

Installation

1. get the source code from latest release or clone this repo => git clone https://github.com/PlankCipher/kabmat.git
2. cd into the source code or cloned repo => cd kabmat
3. run make install

You will be asked to enter your password for sudo to move the executables to /usr/bin/ so that they're accessible from anywhere

Usage

kabmat 2.7.0
TUI program for managing kanban boards with vim-like keybindings

Usage: kabmat [OPTION]...

Options:
  -h, --help              print this help message
  -v, --version           print program version

  -l, --list              list all boards
  -c, --create <name>     create a new board with the name <name>
  -o, --open <name>       open board with name <name>
  -d, --delete <name>     delete board with name <name>

  -t, --text              disable tui
  -b, --card-at-bottom    when moving cards between columns, put them at the bottom

Consult the man page for more information

Keybindings in kabmat

I tried making the keybindings as intuitive and expected as possible, and for the most part they are. For example, generally c creates an entity, d deletes, k moves up, j move down, etc...

Help Window:

Main Menu:

Input Field:

Normal mode:

Insert mode:

Confirmation Window:

Board Screen:

Card Info Window:

Checklist Window:

Window Manager Integration

If you want to launch it sort of like an application you can make a keybinding to launch your terminal with kabmat running instead of the shell. For example, here is how I do it with st and dwm.

st -e sh -c kabmat

static Key keys[] = {
    /* modifier                                key                        function        argument */
    ....
    { (Mod4Mask|Mod1Mask),                     XK_t,                      spawn,          SHCMD("st -e sh -c kabmat") },
    ....
};

NOTE

I have only compiled and tested this program on Linux, so I don't know how it would act on other operating systems.