code

The terminal workspace that tiles itself

Pick a number — get that many shells in a balanced grid.

Linux  •  Open source  •  MIT License

Install

No Rust. No build. Three steps.

1. Download tcode_1.4.0_amd64.deb from the latest release.

2. Install it:

sudo apt install ./tcode_1.4.0_amd64.deb

3. Run it:

tcode        # pick how many panes
tcode 4      # straight to a 2×2 grid

Features

#1 Tile: Many Shells, One Grid Pick a number, get that many panes — equal-split, no dragging, nothing to configure. Every pane is a plain login shell. Move focus, zoom one full-screen, or rebuild the whole grid, all from the keyboard.

#2 View: Open Anything

Code, images, PDFs, office documents, CSV — one viewer, in a tab beside your panes.
Ctrl+click any path to open it. The panel is width-capped, so it never crowds your terminals.

#3 Remember: Nothing You Copy Is Lost Every clip is captured and searchable. Hit Alt+V, type to filter, Enter to paste it back. Pin the ones you reuse — each remembers when you copied it.

#4 Capture: Shoot, Mark Up, Drop In A screenshot annotator, built in. Grab a window or region, draw boxes / arrows / text in any color, then save — and drag the PNG straight into a terminal.

Shortcuts

Panes & layout		Tools & system
Alt + arrows	Move focus between panes (or hjkl)	Alt + V	Clipboard history
Alt + 1…9	Set the pane count	Alt + P	Screenshots strip
Alt + N	New terminal	Ctrl+Shift+C / V	Copy / paste
Alt + Z	Zoom the focused pane	Ctrl + + / − / 0	Zoom the UI
Alt + F	Fullscreen	Alt + Q	Quit
Alt + B	Toggle the file sidebar

_{All shortcuts are also in the app — open the gear (⚙) in the titlebar.}

Configuration

Everything has a sensible default — a config file is optional. To tweak, create ~/.config/tcode/config.toml:

font              = "Martian Mono"   # bundled, or any installed font
font_size         = 11
startup_command   = ""               # run in every pane on open, e.g. "tmux"
clipboard_persist = false            # keep clipboard history across restarts
scale             = 1.0              # whole-UI zoom (0.5–3.0)
# [theme] background / foreground / accent / surface / border / palette

PDF, office, and screenshot features light up when poppler-utils, libreoffice, and xdg-desktop-portal are present — the .deb recommends them automatically.

Build from source

sudo apt install -y build-essential pkg-config \
  libgtk-4-dev libvte-2.91-gtk4-dev libgtksourceview-5-dev
git clone https://github.com/moamen1358/Tcode && cd Tcode
./packaging/install.sh                 # build + install for your user
# …or run it in place:
cargo build --release && ./target/release/tcode 4

Run it three ways, all versioned from Cargo.toml:

./run.sh native    # host binary
./run.sh docker    # container image
./run.sh deb       # build + install the .deb

Maintainers: ./packaging/build-deb.sh builds the .deb; pushing a v* tag publishes it to Releases (.github/workflows/release.yml).

License

MIT © 2026 moamen. Bundled Martian Mono (SIL OFL) and Tabler Icons (MIT) keep their own licenses.