Go(lang) Terminal Window Manager (gotwm)

A terminal-based window manager in Go with taskbar UI, multi-window support, and helper apps for customization.

gotwm was created because I couldn't get mouse support to work in mc while running twin. I figured I would see how hard it would be to build something similar. A few hours—and a lot of vibes—later, and here is gotwm, yay.

Windows can stack

Windows can tile

Build

Run the build script to create binaries in the build/ folder:

./build.sh

This produces:

• build/gotwm
• build/gotwm-shortcuts
• build/gotwm-colors

Run

Start gotwm:

./build/gotwm

Optional: start with an initial command that will run in the first window:

./build/gotwm htop

INSTALL (macOS and Linux)

Copy the binaries to any directory on your PATH, or run them directly from build/.

cp ./build/* ~/.local/bin

Helper apps

gotwm looks for helper apps next to the main binary or in your PATH.

• Shortcuts editor: build/gotwm-shortcuts
• Colors editor: build/gotwm-colors

Config files

User config is stored under:

~/.config/gotwm/

• shortcuts.json
• colors.json