A small terminal emulator written in Zig. Renders to the Linux framebuffer, X11 (XCB + SHM), Wayland (pure Zig wire protocol, no libwayland), or macOS (Cocoa/AppKit, untested). No GPU required.

Originally built for the HackberryPi Zero (RPi Zero 2W + 720x720 HyperPixel4). Runs on any Linux system.

Note: This is an experimental project. It works well enough for daily use with common CLI tools, but it is not a full-featured terminal. See Limitations for what's missing.

Measured on Intel i5-12450H, 1 CPU core, X11 (:0, hardware GPU), -Doptimize=ReleaseFast. See zt-bench for methodology, detailed results, and how to reproduce.

• Four backends — framebuffer (no X11/Wayland), XCB + SHM under X11, pure Zig Wayland client (no libwayland), Cocoa/AppKit on macOS (experimental, untested)
• Pixel scaling — -Dscale=2 or -Dscale=4 for HiDPI. Integer scaling, same font blob
• Double-buffered SHM — tear-free rendering on X11 and Wayland
• Adaptive frame limiter — reduces FPS under heavy output to avoid wasting CPU

• xterm-256color + 24-bit TrueColor — SGR attributes (bold, italic, underline, reverse, dim, strikethrough), styled underlines (single/double/curly/dotted/dashed) with custom colors, DEC modes, alternate screen
• Bracketed paste — DECSET 2004
• CJK wide characters — double-width rendering with boundary repair
• 59,635 glyphs — UFO bitmap font + Nerd Fonts icons, embedded at compile time
• XKB keyboard layout — any X11/Wayland layout (US, JP, DE, FR, etc.)
• Input method — XIM under X11, text-input-v3 under Wayland (fcitx5, ibus, etc.)
• OSC 8 hyperlinks — parsed and stored; click-to-open is not yet implemented
• OSC 52 clipboard — copy to system clipboard via xclip/wl-copy (disabled by default for security)

• Bulk ASCII fast path — SIMD 16-byte range check, 8-byte template cell writes
• UTF-8 bulk path — multi-byte sequences decoded directly in ground state
• Row-map scroll — O(1) scroll via row indirection instead of copying cells
• Damage tracking — per-cell dirty flag, row-level skip
• Comptime configuration — backend, font, palette, scale resolved at compile time

Requires Zig 0.16+.

# X11
zig build -Dbackend=x11 -Doptimize=ReleaseFast

# Wayland
zig build -Dbackend=wayland -Doptimize=ReleaseFast

# Framebuffer (bare Linux console, no X/Wayland)
zig build -Doptimize=ReleaseSmall

# Run
./zig-out/bin/zt

Add -Dstrip=true to remove debug symbols.

# HiDPI (2x or 4x pixel scaling)
zig build -Dbackend=x11 -Dscale=2 -Doptimize=ReleaseFast

# Custom shell (default: /bin/sh)
zig build -Dbackend=x11 -Dshell=/bin/fish -Doptimize=ReleaseFast

# 60fps cap (battery saving)
zig build -Dbackend=x11 -Dmax_fps=60 -Doptimize=ReleaseFast

# Smaller PTY buffer (conserve memory)
zig build -Dbackend=x11 -Dpty_buf_kb=256 -Doptimize=ReleaseSmall

# Cross-compile for aarch64
zig build -Dtarget=aarch64-linux -Doptimize=ReleaseSmall

# macOS (experimental, untested — see note below)
zig build -Dbackend=macos -Dshell=/bin/zsh -Doptimize=ReleaseFast

# Run tests
zig build test

Implements the Wayland wire protocol directly in Zig — no libwayland-client dependency. Only libxkbcommon is needed for keyboard layout.

Supported protocols: xdg-shell, wl_shm, text-input-v3 (IME), wl_data_device + primary selection (clipboard), xdg-decoration, wp_cursor_shape_manager_v1.

Note: Developed without access to macOS hardware and never tested on a real Mac. Uses Cocoa/AppKit via objc_msgSend from Zig. Bug reports welcome.

Edit config.zig and rebuild — st-style, no runtime config files.

pub const backend: Backend = .fbdev;  // set via -Dbackend
pub const keymap: Keymap = .us;       // set via -Dkeymap (fbdev only)
pub const default_fg: u8 = 7;        // white
pub const default_bg: u8 = 0;        // black
pub const font_width: u32 = 8;
pub const font_height: u32 = 16;
pub const scale: u32 = 1;            // set via -Dscale
pub const max_fps: u32 = 120;        // set via -Dmax_fps (0 = unlimited)

Embeds a pre-compiled binary font blob at compile time. The default includes ~60K glyphs (Latin, Japanese, Nerd Fonts icons).

curl -Lo src/fonts/ufo-nf.bin https://github.com/midasdf/zt-fonts/raw/main/ufo-nf.bin

See zt-fonts for sources, build scripts, and custom fonts.

epoll event loop (single-threaded)
├── PTY reader → VT parser → cell grid
│   ├── ASCII fast path (SIMD bulk write)
│   └── UTF-8 fast path (direct decode)
├── Input (evdev / XKB+XIM / XKB+text-input-v3)
├── Renderer (dirty-region, frame-limited)
├── Backend (fbdev mmap / X11 SHM / Wayland wl_shm)
└── Signals, timers, write buffering

vim, nano, micro, less, bat, top, btop, man, git, eza, tree, ripgrep, python3 REPL, fish, Claude Code

Some applications may have minor rendering issues due to missing features (see below).

• No scrollback buffer — only the current viewport
• Mouse support is limited — app mouse tracking and selection work, but there is no scrollback wheel behavior yet
• No clipboard paste on fbdev — X11/Wayland support Ctrl+Shift+V
• No inline pre-edit display — IME uses its own popup window
• No font fallback — single embedded font, no system font lookup
• No ligatures
• No sixel/image protocol
• Blink attribute — parsed but not visually rendered
• fbdev keymap — compile-time only (US/JP); X11/Wayland use XKB

MIT

This project uses AI-generated code (LLM). I do my best to review and test it, but I can't guarantee it's perfect. Please use it at your own risk.\n