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.themeexists, the menu also offersomarchy— 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-themealso 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
.themefile 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
| Key | Controls |
|---|---|
main_bg | popup/dialog background; leave empty for terminal default |
main_fg | body text — table cells, detail values, help descriptions |
inactive_fg | dimmed text — labels, hints, secondary info, timestamps |
hi_fg | highlights: box borders, keybindings, group titles, badges |
title | popup/box titles |
graph_text | accent: process names, UDP badge, emphasis |
net_box | NET box border |
proc_box | LAN box border (btop key name kept for compatibility) |
mem_box | DISK box border (btop key name kept for compatibility) |
download_start/mid/end | download gradient: charts, rx rates, ESTAB badge |
upload_start/mid/end | upload gradient: charts, tx rates |
used_start/mid/end | disk usage colours |
temp_start/mid/end | alert 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.