Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Themes

ltop reads btop-compatible theme files: any btop theme works as-is, and you can write your own — including a two-line file that fixes just the colours you cannot read on your terminal.

Where themes live

  • Built-in: 72 themes — 41 from the btop project’s official collection and 31 from Omarchy’s bundled themes — selectable from the theme menu (m → theme) or --theme <name> on the command line (see Acknowledgements).
  • Omarchy: if ~/.local/state/omarchy/current/theme/btop.theme exists, the menu also offers omarchy — selecting it follows the desktop theme and live-reloads when the desktop theme changes.
  • --follow-theme: picked up at startup is the snapshot; adding --follow-theme also re-colors a running ltop when the desktop theme changes. Off by default (it polls the theme file; opt in when you want the demo from the GIF above).
  • Custom: put a .theme file in ~/.config/ltop/themes/, or load any file directly:
ltop --theme ~/my-colors.theme

A theme loaded with --theme is pinned — it does not follow omarchy.

File format

Key–value pairs, one per line; # lines are comments. Colours accept #RRGGBB, short #RGB, a two-digit grayscale shorthand (#80 = mid grey), and — for main_bg only — an empty value meaning “terminal default” (transparent background, important for terminal-transparency users):

theme[main_fg] = "#c0caf5"
theme[inactive_fg] = "#565f89"

Acknowledgements

The built-in theme library stands on the work of others, and this project is grateful for it:

  • btop (aristocratos/btop) by Aristocratos — ltop’s theme file format is btop’s, and 41 of the embedded themes are converted from btop’s official collection. Thank you to Aristocratos and to every theme author in that collection.
  • Omarchy (dhh/omarchy) by DHH — 31 embedded themes come from Omarchy’s bundled collection. Thank you to DHH and the creators of those themes.

Any theme written for btop or Omarchy keeps working here — their work remains theirs, embedded with credit.

Variable reference

KeyControls
main_bgpopup/dialog background; leave empty for terminal default
main_fgbody text — table cells, detail values, help descriptions
inactive_fgdimmed text — labels, hints, secondary info, timestamps
hi_fghighlights: box borders, keybindings, group titles, badges
titlepopup/box titles
graph_textaccent: process names, UDP badge, emphasis
net_boxNET box border
proc_boxLAN box border (btop key name kept for compatibility)
mem_boxDISK box border (btop key name kept for compatibility)
download_start/mid/enddownload gradient: charts, rx rates, ESTAB badge
upload_start/mid/endupload gradient: charts, tx rates
used_start/mid/enddisk usage colours
temp_start/mid/endalert gradient

Gradients must define all three stops (start/mid/end); a gradient missing any stop is ignored and the built-in default stays.

Minimal example

Only override what you cannot read — everything else falls back to the currently selected built-in theme:

theme[main_fg] = "#e0e0e0"
theme[inactive_fg] = "#909090"

Save as ~/.config/ltop/themes/readable.theme, then pick readable from the theme menu.

Full example

The easiest full theme is copying a built-in btop theme and editing:

cp /usr/share/btop/themes/dracula.theme ~/.config/ltop/themes/my.theme

For reference, the shape of a complete file (Dracula palette):

theme[main_bg] = "#282a36"
theme[main_fg] = "#f8f8f2"
theme[title] = "#bd93f9"
theme[hi_fg] = "#8be9fd"
theme[inactive_fg] = "#6272a4"
theme[graph_text] = "#ff79c6"
theme[net_box] = "#bd93f9"
theme[proc_box] = "#ff79c6"
theme[mem_box] = "#8be9fd"
theme[download_start] = "#8be9fd"
theme[download_mid] = "#8be9fd"
theme[download_end] = "#57c7ff"
theme[upload_start] = "#ff79c6"
theme[upload_mid] = "#ff79c6"
theme[upload_end] = "#bd93f9"
theme[used_start] = "#50fa7b"
theme[used_mid] = "#f1fa8c"
theme[used_end] = "#ff5555"
theme[temp_start] = "#50fa7b"
theme[temp_mid] = "#f1fa8c"
theme[temp_end] = "#ff5555"

Known limitation

The LAN box’s MAC column is hidden on macOS regardless of theme — the system sanitizes it for non-Apple-signed binaries. See Compatibility.