A tabbed tiling window manager for X11, inspired by Notion.
This entire project was written by Claude Code.
ttwm combines tiling layouts with tabbed window organization. Multiple windows share the same frame as tabs, and frames can be split to create complex layouts. Tab bars can be horizontal (top of frame) or vertical (left side) for different workflows.
- Tabbed frames - Stack windows as tabs within frames, like browser tabs
- Horizontal or vertical tab bars - Choose per-frame tab orientation
- Flexible tiling - Split frames horizontally or vertically with adjustable ratios
- Startup layouts - Define complex layouts and auto-launch apps in config
Requires Rust 1.70+, X11, and FreeType development libraries.
# Debian/Ubuntu
sudo apt install build-essential libx11-dev libxcb1-dev libfreetype6-dev
# Arch
sudo pacman -S base-devel libx11 libxcb freetype2git clone https://github.com/adereth/ttwm.git
cd ttwm
cargo build --releasemkdir -p ~/.config/ttwm
cp config.toml.example ~/.config/ttwm/config.toml| Key | Action |
|---|---|
Mod4+s |
Split horizontally |
Mod4+v |
Split vertically |
Mod4+/ |
Toggle vertical tabs |
Mod4+Arrow |
Focus frame in direction |
Mod4+Page_Down/Up |
Cycle tabs |
Mod4+q |
Close window |
- User Guide - Configuration and usage
- Developer Guide - Architecture
MIT