Skip to content
programmersd21Public

Repository files navigation

venti logo
fast, quiet terminal multiplexer for linux.

build crates.io aur version license rust issues stars last commit repo size

demo

venti demo

features

  • sixel graphics: clipped and tracked with pane scrolling, powered by icy_sixel
  • kitty graphics protocol: image transmission, placements, scrolling, and resize 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
  • 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+tab folds the workspace sidebar away in every profile
  • fast: event-driven, diff-based updates, minimal cpu

install

arch linux

yay -S venti-bin

use paru -S venti-bin if you use paru.

build from source

git clone https://github.com/programmersd21/venti
cd venti
cargo build --release
sudo cp target/release/venti /usr/local/bin/

quick start

venti

auto-creates config at ~/.config/venti/config.toml.

  • f1 = help + keybindings
  • f2 = settings menu (live editor, including switching the four profiles)
  • f11 = command palette
  • f12 = theme picker

press f1 for complete reference or read docs/keybindings.md.

keybindings

workspace navigation

alt+1..9     switch to workspace 1-9
alt+n        new workspace
alt+w        close workspace

pane navigation (beginner, default profile)

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.

functions

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

configuration

~/.config/venti/config.toml (auto-created):

[general]
shell = ""   # empty: $SHELL, falls back to /bin/sh
scrollback = 10000
graphics = true  # enables Kitty and Sixel graphics forwarding

[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

design

  • linux only: vt100 terminal emulation via term-wm-vt100 (patched)
  • graphics support: kitty graphics and sixel are selected from the attached terminal's TERM and TERM_PROGRAM identity
  • 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)

commands

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 config

development

cargo build           # debug build
cargo build --release # release binary
cargo test --no-fail-fast  # run all tests
cargo test --test sixel_graphics_test  # sixel rendering verification
cargo clippy          # lint

documentation

  • docs/quickstart.md - hands-on tutorial
  • docs/keybindings.md - complete reference
  • docs/configuration.md - config file guide
  • docs/architecture.md - internal design
  • docs/protocol.md - wire protocol specification
  • docs/zsh.md - zsh setup and completions
  • docs/index.md - faq and troubleshooting

graphics

venti forwards kitty graphics protocol and sixel sequences, subject to the attached terminal's detected capabilities. iterm2 image sequences are unsupported. see graphics documentation for protocol scope and limitations.

contributing

issues, discussions and pull requests are welcome - see contributing.md for the workflow, the code style and how to run the test suite.

license

mit

credits

inspired by tmux, zellij, helix.

built with ratatui, crossterm, serde, icy_sixel.

colors from catppuccin.


venti 0.2.0, 2026-11-19

a fast, quiet terminal multiplexer for linux.