hydra

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

README.md (1772B)

      1 # Hydra SketchyBar widget
      2 
      3 Shows Hydra's live routing state in your bar: an amber 󰓃 when routing, dim when idle or
      4 the daemon is down, and a red label if a route is clipping.
      5 
      6 It reads state through `hydra query --sketchybar` (the same `hydra-ipc` contract the TUI
      7 uses — no socket parsing in shell), so it works the moment the daemon is up.
      8 
      9 ## Add it to your `sketchybarrc`
     10 
     11 Remember your ordering rule — **first added = rightmost**, so add Hydra where you want it
     12 relative to your other right-side items.
     13 
     14 ```sh
     15 PLUGIN="$HOME/Library/CloudStorage/Dropbox/Projects/Apps/hydra/scripts/sketchybar/hydra.sh"
     16 
     17 # A custom event the daemon triggers on state changes (instant updates), plus a slow
     18 # poll as a safety net for meter movement.
     19 sketchybar --add event hydra_route_change
     20 
     21 sketchybar --add item hydra right \
     22            --set hydra update_freq=2 \
     23                  script="$PLUGIN" \
     24                  icon.font="$FONT:Bold:16.0" \
     25                  label.font="$FONT:Medium:12.0" \
     26            --subscribe hydra hydra_route_change
     27 ```
     28 
     29 `update_freq=2` keeps the meter/label fresh; the `hydra_route_change` event makes
     30 start/stop/mute reflect instantly (the daemon fires
     31 `sketchybar --trigger hydra_route_change` on those mutations). The script also sources
     32 `$CONFIG_DIR/theme.sh` if present, so it tracks your suite palette automatically.
     33 
     34 ## Notes
     35 
     36 - The plugin auto-locates the `hydra` binary (release preferred, debug fallback). Override
     37   with `HYDRA_BIN=/path/to/hydra` in the item's environment if you install it elsewhere.
     38 - Glyphs (`󰓃`, `󰜺`) are Nerd Font; swap them for whatever your bar's icon font provides.
     39 - This file is not auto-installed into `~/.config/sketchybar` — copy/symlink it yourself so
     40   your dotfiles stay the source of truth.