hydra

Terminal replacement for Loopback — virtual audio devices and routing on macOS, from a ratatui TUI.
Log | Files | Refs | README | LICENSE

README.md (2117B)

      1 # Hydra themes
      2 
      3 Hydra's colors are fully swappable, btop-style: **drop a `.toml` file in
      4 `~/.config/hydra/themes/` and it appears in the TUI theme picker** (press `t`). No rebuild,
      5 no config syntax to learn beyond hex colors.
      6 
      7 ## Quick start
      8 
      9 ```sh
     10 mkdir -p ~/.config/hydra/themes
     11 cp themes/abyssal.toml ~/.config/hydra/themes/mytheme.toml
     12 # edit the hex values, then in Hydra press `t` and pick "mytheme"
     13 ```
     14 
     15 The files in *this* folder (`abyssal.toml` = the built-in default, `transparent.toml`, …)
     16 are examples — copy them
     17 into your config folder to use/edit them.
     18 
     19 ## Format
     20 
     21 Every key is optional; unspecified keys fall back to the built-in default, so a theme can be
     22 as small as a single line.
     23 
     24 ```toml
     25 name = "mytheme"          # optional; the picker uses the filename anyway
     26 transparent = false       # true = let the terminal background show through
     27 
     28 [palette]
     29 bg          = "#16181d"   # main background (ignored when transparent)
     30 bg_elevated = "#22262e"   # overlays, selected rows
     31 fg          = "#e6e8ea"   # primary text
     32 fg_dim      = "#8a9099"   # hints, secondary text
     33 accent      = "#e09b3e"   # selected output, marks
     34 ghost       = "#4cc2b0"   # titles, cursor, active selection
     35 border      = "#3a404a"   # pane borders
     36 success     = "#6cc66c"
     37 warning     = "#e09b3e"
     38 danger      = "#e06c6c"
     39 ```
     40 
     41 ## Transparency (Ghostty / vibrancy)
     42 
     43 Set `transparent = true` in a theme, or toggle it live in the TUI with **`T`**. In
     44 transparent mode Hydra stops painting its background, so the terminal's own background
     45 (Ghostty's transparency/vibrancy, etc.) shows through. UI chrome — selection highlights and
     46 the floating overlays — stays opaque so it remains readable.
     47 
     48 ## Controls
     49 
     50 - `t` — open the theme picker (live preview on apply, persisted)
     51 - `T` — toggle background transparency
     52 - `hydra --theme /path/to/file.toml` — one-shot override (not persisted)
     53 
     54 Your active choice + transparency are saved to `~/.config/hydra/ui.toml`.
     55 
     56 > Note: this repo intentionally ships only neutral example themes. Personal palettes live in
     57 > your own `~/.config/hydra/themes/` (and stay in their own repos).