fast, quiet terminal multiplexer for linux.
Note
terminal graphics support is currently experimental and may be unreliable. contributions and help with protocol compatibility, rendering bugs, and testing are very welcome. see graphics protocol support.
- multiple workspaces: organize panes across independent workspace sets
- tiled layouts: dwindle (default) or monocle, with configurable splits
- floating panes: drag-and-drop, drag-resize corners
- four keybinding profiles: beginner (mouse+f-keys), hypr (hjkl power set), vim (vi grammar), dev (editor/IDE ergonomics)
- copy mode: vim-like scrollback search and selection
- live settings: edit 40+ options via f2, changes apply instantly
- bright ui: centered dialogs, colorful CLI
- graphics (experimental): sixel, kitty image protocol, iterm2 inline images - see graphics protocol support
- workspace tab context menu: right-click a tab for rename / new / close, anchored at the click
- scroll indicator: optional "↑12" marker in the pane title while scrolled back
- sidebar fold:
shift+tabfolds the workspace sidebar away in every profile - fast: event-driven, diff-based updates, minimal cpu
git clone https://github.com/programmersd21/venti
cd venti
cargo build --release
sudo cp target/release/venti /usr/local/bin/ventiauto-creates config at ~/.config/venti/config.toml.
f1= help + keybindingsf2= settings menu (live editor, including switching the four profiles)f11= command palettef12= theme picker
press f1 for complete reference or read docs/keybindings.md.
alt+1..9 switch to workspace 1-9
alt+n new workspace
alt+w close workspace
alt+arrows focus left/down/up/right
f10 resize mode
f3 new pane (split right)
f4 close pane
hypr/vim profiles bind alt+hjkl to focus and alt+shift+hjkl to swap; dev profile binds arrows + alt+enter new pane. see docs/keybindings.md.
f1 help
f2 settings
f5 zoom toggle (monocle)
f6 floating toggle
f8 search scrollback
f9 copy mode
f11 command palette
f12 theme menu
in hypr and vim profiles:
alt+space command palette (hypr)
alt+p rotate split (hypr)
alt+t theme menu
alt+s toggle sidebar
all multiplexer bindings use alt (escape-prefixed, reliable everywhere terminals speak). apps receive untouched plain ctrl+key sequences.
full reference: docs/keybindings.md
custom bindings: edit [binds] in ~/.config/venti/config.toml
~/.config/venti/config.toml (auto-created):
[general]
shell = "" # empty: $SHELL, falls back to /bin/sh
scrollback = 10000
graphics = false # experimental; set true to try images
[decorations]
border_style = "rounded"
pet = true
pet_emoji = "🐱"
[ui]
show_pwd = true
show_hostname = true
workspace_bar = "top"
[theme]
name = "mocha" # 15 builtin dark themes
[binds]
# override any keybinding
"alt+3" = "workspace_goto 2"
"alt+shift+3" = "move_to_workspace 3"
"alt+shift+w" = "close_workspace"live editing: press f2 in venti to adjust 40+ settings.
docs: docs/configuration.md
- linux only: vt100 terminal emulation via term-wm-vt100 (patched)
- fast: event-driven, minimal allocations, diff-based rendering
- minimal deps: ratatui, crossterm, serde, nix syscalls
- no ui framework overhead: custom rendering for perfect pixel control
- bright & readable: catppuccin mocha + 14 other dark themes
- four profiles: beginner, hypr, vim, dev, composable commands, fast fingers
- alt-first keybindings: escape-prefixed combos work in most terminals (see docs)
see docs/architecture-assessment.md for known limitations and planned
improvements (terminal emulator migration, per-pane cursor shape, graphics
ownership redesign).
venti # attach to default session
venti new -s myproject # create and attach to a named session
venti ls # list sessions
venti send -t default "ls -la" # send keys to pane
venti run -t default workspace_goto 2 # run command
venti kill -t default # kill session
venti doctor # system check
venti config check # validate configcargo build # debug build
cargo build --release # release binary
cargo test --no-fail-fast # run all tests
cargo test --test keybindings_regression_test # keybinding tests
cargo test --test graphics_conformance_test # real kitten icat / chafa round-trip
cargo clippy # lint (zero warnings)docs/quickstart.md- hands-on tutorialdocs/keybindings.md- complete referencedocs/configuration.md- config file guidedocs/architecture.md- internal designdocs/protocol.md- wire protocol specificationdocs/graphics-unicode-placeholders.md- graphics protocols and unicode placeholdersdocs/kitty-config.md- kitty configuration for use with ventidocs/zsh.md- zsh setup and completionsdocs/index.md- faq and troubleshooting
venti is still working towards reliable terminal graphics protocol support.
image rendering is currently unreliable, and some protocols may not work as expected across terminal emulators, particularly during pane resizing, scrolling, and layout changes.
this is an area where help is genuinely welcome.
if you have experience with terminal graphics protocols, rendering pipelines, or terminal emulator compatibility, contributions, debugging help, and technical suggestions are very welcome.
if you encounter issues, have ideas, or know how to improve the implementation, please open an issue or start a discussion. even small reproductions and compatibility reports are valuable.
i would especially appreciate help from people familiar with:
- kitty graphics protocol
- sixel
- iterm2 image protocol
- terminal rendering and multiplexer compatibility
venti is an independent project, and improving graphics support is an ongoing effort. thanks to everyone willing to investigate, test, and contribute.
graphics is off by default. it is experimental; set graphics = true under
[general] to try it. venti doctor prints the same reminder.
where to help:
- github issues: concrete bugs, reproducible failures, compatibility reports
- github discussions: technical ideas, implementation approaches, requests for help
- pull requests: actual fixes and improvements
current state, honestly:
| protocol | tested | state |
|---|---|---|
| kitty graphics | most tested and most stable | transmit, place, re-place, crop-to-pane, scrollback anchoring, unicode placeholders, file-backed (t=f/t=s) transmissions (read once, re-sent inline and chunked) all work; edge cases remain around float/reflow geometry |
| sixel | weaker | parse, render and scroll work; needs a sixel-capable outer terminal; re-placement after a resize rides on a full ESC[2J repaint |
| iterm2 inline images | not well tested | display works; no cropping, no source-offset re-placement, no per-pane clipping |
kitty is the protocol to rely on today: it is what kitten icat, yazi and fastfetch use, and every code path is covered by unit tests plus the real-tool conformance suite. sixel is a fallback for terminals without kitty support. iterm2 is best-effort.
images are re-transmitted in spec-compliant chunks (max 4096 base64 bytes per apc, m=1/m=0), the payload never leaks into the text stream, and file-backed pixels are cached at transmission time so the app deleting its temp file cannot blank the frame.
the parsers and the framing are covered by cargo test graphics, and tests/graphics_conformance_test.rs runs the real tools (kitten icat, chafa -f sixels) against a real server to check that the payload never reaches the text stream, that the image actually arrives and that every chunk respects the 4096-byte limit.
issues, discussions and pull requests are welcome - see contributing.md for the workflow, the code style and how to run the test suite.
graphics protocol work is the area where help is most needed, see graphics protocol support.
mit
inspired by tmux, zellij, helix.
built with ratatui, crossterm, serde.
colors from catppuccin.
venti 0.1.0, 2026-11-16
a fast, quiet terminal multiplexer for linux.
