TERMIUM / DOCUMENTATION
Quickstart
From your terminal to your first page in one command. Linux x86-64, macOS Apple Silicon/Intel, and Windows (WSL2 x86-64).
Install and open
On Windows, open your WSL2 Linux shell in Windows Terminal (Preview), available from the Microsoft Store, and run the command below there. This setup supports Sixel graphics.
curl -fsSL https://termium.dev/install | bash
Setup supplies the private runtime, downloads and verifies Chromium and Vimium, configures your shell, and opens Termium. No development tools, separate browser installation, or sudo required. The installer checks platform compatibility before activation; see installation for requirements and troubleshooting.
Find your way around
- Ctrl+L: enter an address, then press Enter.
- f: show link hints, then type a link’s label.
- j / k: scroll down / up. Click a text field to type normally.
- t: open a tab. J / K: switch tabs. x: close the current tab.
- F6: toggle Mouse keys. Enter left-clicks, r right-clicks, m middle-clicks.
- F1: Termium help. ?: Vimium help.
- Ctrl+Q, then Enter: quit.
The top bar also has tabs, Back, Forward, Reload, an address field, and Menu (F10). Mouse clicks, dragging, and scrolling work alongside keyboard navigation.
On the development build, Menu also includes Developer tools (F12), Copy selected text (F8), and Extensions. Paste with your terminal's paste shortcut. See Browser tools for availability, selection, clipboard requirements, and unpacked extension loading.
Kitty or sixel graphics are selected automatically, with an ASCII graphics fallback when neither is available. To try the fallback explicitly, use termium --renderer tcell in a new terminal.
Mouse keys
Press F6 once to enable mouse keys, then move the pointer with arrows or h/j/k/l. These controls apply while the mode is on:
| Key | Action |
|---|---|
| Enter | Left-click |
| r | Right-click |
| m | Middle-click |
| Space | Hold the left button; move, then press Space again to release |
| u / d | Scroll up / down |
| Escape or F6 | Leave mouse keys mode |
Leave mouse keys mode before typing into a page field. Full mouse keys reference.
Come back anytime
In a new terminal, run this from any directory:
termium example.com
Termium remembers your chosen home page when you run termium --set-homepage https://example.com. Tabs and browsing profiles do not persist after quitting yet.
To update, close running Termium sessions and rerun the install command. Run termium --doctor if startup fails.