Glyph Logo
GLYPH
Checking release...
DOCUMENTATION

Glyph Manual & Architecture

Everything you need to master Glyph: configuration reference, keyboard navigation, OSC 133 semantic shell hooks, and native Rust IPC internals.

README on GitHub

Quick Start

Glyph is distributed as native 64-bit Linux binaries. After installing the package for your distribution, you can launch Glyph directly from your application launcher or via terminal:

glyph --workspace default

Keyboard Shortcuts Cheat Sheet

Every pane operation, workspace switch, and font adjustment is engineered to be zero-mouse operable:

Split pane horizontallyCtrl + Shift + D
Split pane verticallyCtrl + Shift + E
Close focused paneCtrl + Shift + W
Navigate pane focus (Vim keys)Alt + H / J / K / L
Toggle live search barCtrl + Shift + F
New terminal workspaceCtrl + Shift + T
Cycle active workspacesCtrl + PageUp / Down
Zoom font size in / outCtrl + Shift + + / -
Reset font zoom to defaultCtrl + Shift + 0
Copy selection / Paste clipboardCtrl + Shift + C / V

Configuration (~/.config/glyph/config.toml)

Glyph uses declarative TOML for its configuration. Changes made to this file are hot-reloaded automatically by the Rust file-watcher without restarting your sessions.

[window]
decorations = false
opacity = 0.98
blur = true
padding = { x = 12, y = 10 }

[font]
family = "JetBrains Mono"
size = 13.5
line_height = 1.35
weight = "Regular"

[cursor]
style = "block" # "block" | "beam" | "underline"
blink = true
blink_interval_ms = 500

[theme]
active = "industrial-light"
contrast = 1.0

[shell]
program = "/bin/bash"
args = ["--login"]
osc133_integration = true

OSC 133 Semantic Shell Hooks

Glyph supports semantic terminal escape sequences (OSC 133). When enabled, Glyph detects when prompts start, when commands begin executing, and exact exit codes to display in pane status bars:

# Add to ~/.bashrc for Glyph OSC 133 semantic integration:
__glyph_prompt_start() { printf "\033]133;A\007"; }
__glyph_command_start() { printf "\033]133;C\007"; }
__glyph_command_executed() {
  local ret=$?
  printf "\033]133;D;%d\007" "$ret"
  return $ret
}
PROMPT_COMMAND="__glyph_command_executed; __glyph_prompt_start; $PROMPT_COMMAND"
PS1="\[\033]133;B\007\]$PS1"

Native Rust Architecture

Glyph is built on a 3-tier decoupled architecture designed for sub-millisecond input response and crash resilience:

1. Rust Backend & PTY Orchestrator

Direct Linux pseudo-terminal allocation via portable-pty. Spawns shells asynchronously with dedicated OS threads and zero GC pauses.

2. Tauri v2 Zero-Cost IPC Bridge

Binary data streaming between Rust native threads and the webview renderer over asynchronous IPC channels with zero JSON serialization overhead.

3. Hardware-Accelerated xterm.js Canvas

WebGL terminal rendering engine capable of sustained 120 FPS output during intensive compile jobs, log streaming, and continuous visual matrices.