60 lines
2.4 KiB
Markdown
60 lines
2.4 KiB
Markdown
# `theme.srf` reference
|
|
|
|
`theme.srf` recolors the interactive TUI. zfin reads it from
|
|
`~/.config/zfin/theme.srf`. When the file is absent, built-in defaults
|
|
(a monokai/opencode palette) apply; when present, it is the **sole**
|
|
source of colors.
|
|
|
|
Generate a commented starting file from the current defaults:
|
|
|
|
```bash
|
|
zfin interactive --default-theme > ~/.config/zfin/theme.srf
|
|
```
|
|
|
|
## File format
|
|
|
|
One `key::value` per line. Every value is a hex RGB string,
|
|
`#rrggbb`:
|
|
|
|
```srf
|
|
#!srfv1
|
|
bg::#0a0a0a
|
|
text::#eeeeee
|
|
accent::#9d7cd8
|
|
positive::#7fd88f
|
|
negative::#e06c75
|
|
```
|
|
|
|
## Color keys
|
|
|
|
| Key | Used for |
|
|
|----------------------------------------|-------------------------------------|
|
|
| `bg` | Main background |
|
|
| `bg_panel` | Panel background |
|
|
| `bg_element` | Inset element background |
|
|
| `tab_bg` / `tab_fg` | Inactive tab bar |
|
|
| `tab_active_bg` / `tab_active_fg` | Active tab |
|
|
| `text` | Primary text |
|
|
| `text_muted` | Secondary text |
|
|
| `text_dim` | De-emphasized text |
|
|
| `status_bg` / `status_fg` | Status line |
|
|
| `input_bg` / `input_fg` / `input_hint` | Modal text input |
|
|
| `accent` | Accent / highlights |
|
|
| `positive` | Gains, positive values |
|
|
| `negative` | Losses, negative values |
|
|
| `warning` | Warnings (e.g. stale manual prices) |
|
|
| `info` | Informational highlights |
|
|
| `select_bg` / `select_fg` | Selected row |
|
|
| `border` | Borders and rules |
|
|
|
|
Run `zfin interactive --default-theme` for the full key list with the
|
|
default values filled in.
|
|
|
|
## See also
|
|
|
|
- [Customize the TUI](../../guides/customize-the-tui.md) -- the walkthrough.
|
|
- [`keys.srf`](keys-srf.md) -- rebind keys.
|
|
|
|
---
|
|
|
|
[Documentation home](../../README.md#reference)
|