Repository navigation
Getting Started
The first time tron starts, it shows the startup screen before your shell. The screen has these tabs:
| Tab | Contents |
|---|---|
| Overview | A welcome and what tron can do |
| Settings | Font, window, cursor and other settings, previewed live |
| Themes | Every built-in and custom theme, previewed on the terminal |
| Shaders | Built-in and custom shaders, previewed live |
| Keys | The key bindings |
| Tour | A walk through tron's features |
| Credits | Authors and licenses of the themes, shaders and libraries tron ships with |
| About | Version and links |
Tab and Shift+Tab (or the number keys 1 to 8) switch tabs. The arrow
keys select and change items, and each tab shows its keys at the bottom.
Esc leaves the startup screen and starts your shell.
-
tron --startupopens the startup screen at any time. Run inside a tron window, it takes over that window. -
tron settings,tron themes,tron shaders,tron keys,tron tour,tron credits,tron aboutandtron overviewopen that tab directly, skipping the splash. Inside a tron window they open in the window; elsewhere they open a new window. -
startup = falseinconfig.tomlnever shows it.startup = trueshows it on every launch. -
startup_animations = false, or the environment variableTRON_STARTUP_ANIMATIONS=0, turns its animations off.
tron [OPTIONS] [COMMAND]
-e, --command <PROGRAM>... Run a program instead of the shell
-d, --working-directory <DIR> Start in this directory
--config-dir <DIR> Use this configuration directory
--startup Show the startup screen: welcome, setup and tour
-V, --version Print the version
tron settings Change settings with a live preview
tron themes Preview and pick a color theme
tron shaders Preview and pick post-processing shaders
tron keys Show the key bindings
tron tour Take the tour of tron's features
tron credits Show who made the themes, shaders and libraries
tron about Show the version and links
tron completions <SHELL> Print shell completions (bash, zsh, fish, ...)
Every tron window has a tron command on its PATH, whatever way tron was
installed: from the disk image, as an AppImage, as a Flatpak or with the install
script. tron writes a small launcher to ~/.local/share/tron/bin/tron when it
starts, and it runs the tron that opened the window. tron settings therefore
always works inside tron.
To use tron in other terminals too, see Installation for each package.
Examples:
tron -e htop # run htop in a new window
tron -d ~/projects -e nvim . # open nvim in a directoryOn Linux the defaults use Ctrl+Shift; on macOS they use Cmd. See
Key Bindings for the full list and how to change the bindings.
| Linux | macOS | Action |
|---|---|---|
Ctrl+Shift+C / Ctrl+Shift+V
|
Cmd+C / Cmd+V
|
Copy / paste |
Shift+Insert, middle click |
Shift+Insert, middle click |
Paste the primary selection |
Ctrl+= / Ctrl+- / Ctrl+0
|
Cmd+= / Cmd+- / Cmd+0
|
Bigger / smaller / reset font |
Shift+PageUp / Shift+PageDown
|
same, or Cmd+PageUp / Cmd+PageDown
|
Scroll a page |
Shift+Home / Shift+End
|
Cmd+Home / Cmd+End
|
Scroll to top / bottom |
Ctrl+Shift+F |
Cmd+F |
Find in the scrollback |
Ctrl+Shift+P |
Cmd+Shift+P |
Command palette |
Ctrl+Shift+Z / Ctrl+Shift+X
|
Cmd+Up / Cmd+Down
|
Previous / next shell prompt |
Ctrl+Shift+G |
Cmd+Shift+Up |
Select the last command's output |
Ctrl+Shift+N |
Cmd+N |
New window in the current directory |
Ctrl+Shift+, |
Cmd+, |
Reload the configuration |
Ctrl+Shift+Backspace |
Cmd+Backspace |
Delete the line before the cursor |
Ctrl+Shift+Left / Ctrl+Shift+Right
|
Cmd+Left / Cmd+Right
|
Beginning / end of the line |
Option+Backspace |
Delete the word before the cursor | |
Ctrl+click |
Cmd+click |
Open a link |
On macOS, tron has a menu bar with tron, File, Edit, View, Window and Help menus. The menu items show the shortcuts from your Key Bindings, and they update when the configuration reloads. Right-click tron in the Dock for New Window.
All windows run in one tron process, so the Dock shows tron once. New Window opens in the current shell's folder. Closing a window closes only that window, and tron quits after the last one.
tron > Settings… opens the Settings tab in the window you are using. Your
shell keeps running behind it and comes back when you close the settings with
Esc.
Right-click or Control-click in a window for a context menu with Copy, Paste,
Find…, Command Palette…, New Window and Settings…. Programs that use the mouse,
such as vim or tmux, get the click instead unless you hold Shift.
Force click a word, or tap it with three fingers, to look it up in the macOS dictionary. tron picks the same word that a double click selects.
The title bar shows the icon of the shell's current folder beside the title.
Drag it like a file, or Command-click it to see the parent folders. tron takes
the folder from OSC 7 when the shell reports it, and otherwise reads it from the
shell process. Until a program sets a title, the window is named after that
folder, such as ~ or ~/Programming.
Ctrl+Shift+F (Cmd+F on macOS) opens the Find box at the top right of the
window. Type to search the scrollback. Enter jumps to an older match,
Shift+Enter to a newer one, and Esc closes the box. The search ignores case
unless the query contains uppercase letters.
Ctrl+Shift+P (Cmd+Shift+P on macOS) opens the command palette at the top
right of the window. It lists every command with its shortcut: copy and paste,
command output, scrolling, font size, New Window, Settings, reloading the
configuration and the help links. Type to filter, by words or by initials (cco
finds Copy Command Output). Up, Down and Tab pick a command, Enter runs
it, and Esc closes the palette.
The palette also works with the mouse: hover a command to highlight it, click to run it, and scroll the list with the wheel. The pointer turns into a hand over the commands. A scrollbar on the right border shows where you are in the list. Clicking outside the palette closes it.
The Find box and the palette are drawn by tron over the terminal and take the keys and mouse themselves, so programs inside, such as tmux, never see what you type or click there.
- Drag to select. Double click selects a word, triple click a line.
-
Alt+drag selects a rectangular block.Shift+click extends the selection. - When an application uses the mouse (vim, htop, tmux), hold
Shiftto select text anyway. - A selection is copied to the primary selection, so middle click pastes it. Set
copy_on_select = falseunder[selection]to turn that off. -
word_separatorsunder[selection]sets which characters end a word for double click. - Dropping files on the window inserts their shell-quoted paths.
- The mouse wheel scrolls 3 lines per step; change it with
multiplierunder[scrollback]. - On macOS, an overlay scrollbar appears on the right edge while you scroll through the history and fades out a moment later. Hover it to make it wider, drag the thumb to scroll, or click beside the thumb to jump there.
When a coding agent harness starts in a window, a thin line in the color of its
brand sweeps from the center of the top edge out to both sides and fades. It
sweeps only for a harness that just started: switching to a tmux pane or window
where one already runs, attaching to a tmux session or bringing a suspended one
back with fg leaves the line alone. tron
recognizes Claude Code (claude), Codex (codex), opencode, pi, Gemini CLI
(gemini), Amp, Crush, Qwen Code (qwen) and Cursor's agent (cursor-agent),
also when they run through node, bun or npx, and inside tmux.
Turn the line off with line = false under [harness]. Colors under
[harness.colors], by command name, replace the brand colors or add other
harnesses:
[harness.colors]
claude = "#d97757"
my-agent = "#44cc88"Once a day at most, tron asks GitHub for the latest release, with curl. When
a newer one is out, a notice in the bottom right corner of each window tells
you, with three buttons:
- Open opens the release page.
- Close hides the notice until tron starts again.
- Don't show again hides it for that release. The next release shows the notice again.
The buttons take mouse clicks and show a hand pointer; the notice leaves your
keys to the terminal. Set check = false under [updates] to never ask
GitHub.
Ctrl+click (Cmd+click on macOS) opens a link. tron detects URLs in the
text and follows OSC 8 hyperlinks that programs such as ls --hyperlink print.
Links open with xdg-open on Linux and open on macOS; change the command with
open_command under [links].
tron exposes the screen to screen readers: Orca over AT-SPI on Linux, and
VoiceOver on macOS. Set TRON_ACCESSIBILITY=0 to turn this off.
Using tron
Looks
Features
Reference