WinJitsu is a lightweight CLI tool for Linux X11 that gives you fast, animated control over your windows. Snap any window to halves, quarters, or corners; toggle fullscreen with configurable padding; move windows between monitors — all driven by simple keyboard shortcuts and a background daemon that makes hotkey responses feel instant.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Evilchuck666/WinJitsu/llms.txt
Use this file to discover all available pages before exploring further.
Installation
Install WinJitsu from the AUR or build a wheel from source. Supports Arch, Debian, and Fedora.
Quickstart
Start the daemon, bind a hotkey, and snap your first window in under two minutes.
Actions Reference
Full reference for all 14 window actions: grid snapping, fullscreen, restore, and display toggle.
Configuration
Tune animation speed, fullscreen padding, and daemon debounce delay via config file or CLI flags.
How it works
WinJitsu runs as a background daemon that listens on a Unix socket. When you fire a hotkey likewinjitsu N, the client sends the action code to the daemon, which applies a short debounce window and then animates the active window to its new position using smoothstep interpolation via xdotool.
Install dependencies
Make sure
xdotool and python-xlib are installed for your distro, then install WinJitsu.Start the daemon
Run
winjitsu --daemon once at login. The daemon stays in the background and handles all actions.Bind hotkeys
Map keyboard shortcuts in your window manager (i3, GNOME, KDE, etc.) to
winjitsu <ACTION>.Daemon Mode
Run as a background process for instant, debounced hotkey responses.
Hotkey Binding
Example configs for i3, GNOME, KDE, and other window managers.
Multi-Monitor
Move windows between displays with the TD action.