Skip to content

Getting Started

Ö. Efe D. edited this page Sep 16, 2026 · 8 revisions

Getting Started

The startup screen

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 --startup opens 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 about and tron overview open that tab directly, skipping the splash. Inside a tron window they open in the window; elsewhere they open a new window.
  • startup = false in config.toml never shows it. startup = true shows it on every launch.
  • startup_animations = false, or the environment variable TRON_STARTUP_ANIMATIONS=0, turns its animations off.

Command line

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, ...)

The tron command

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 directory

Everyday keys

On 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

The macOS menu bar

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.

Find

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.

Command palette

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.

Selection and the mouse

  • 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 Shift to select text anyway.
  • A selection is copied to the primary selection, so middle click pastes it. Set copy_on_select = false under [selection] to turn that off.
  • word_separators under [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 multiplier under [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.

Coding agents

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"

Updates

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.

Links

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].

Accessibility

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.

Clone this wiki locally