# yabridge-tui

![yabridge-tui screenshot](yabridge-tui.png)

TUI wrapper for yabridgectl. Manage Windows VST2/VST3/CLAP plugins on Linux without typing commands.

Browse your bridged plugins, add/remove directories with a file picker,
sync, and edit per-plugin yabridge.toml options — all from one terminal screen.

## Requirements

- yabridgectl (https://github.com/robbert-vdh/yabridge)
- A terminal with true color support

## Usage

    yabridge-tui

## Keybindings

### Global

    h/l/Tab       switch tabs
    1-4           jump to tab
    T             cycle color theme
    ?             help
    q             quit

### Plugins

    j/k           navigate
    u/d           page up/down
    g/G           top/bottom
    f /           filter (fuzzy)
    t             cycle type filter (All/VST2/VST3/CLAP)
    o             cycle sort (name/type/status)
    s             sync plugins
    S             force sync
    p             sync with prune
    r             refresh

### Paths

    j/k           navigate
    f /           filter
    a             add path (opens file browser)
    d             remove path

### File Browser (Paths > a)

    j/k           navigate
    l/Right       open directory
    h/Left/Bksp   parent directory
    f /           filter
    Enter         select current directory
    Esc           close

### Config (yabridge.toml editor)

    Enter         edit rule fields
    e             edit rule pattern
    a             add rule (Tab: autocomplete plugin names)
    d             delete rule
    Space         cycle bool: unset > yes > no > unset
    x             clear field
    w             save
    r             reload config

### Log

    j/k           scroll up/down
    d/u           page down/up
    g/G           top/bottom
    f /           filter
    c             clear

## Tabs

    Plugins       list bridged plugins, sync status, filter by name/type
    Paths         manage plugin directories via file browser
    Config        edit yabridge.toml rules (per-plugin options)
    Log           command output, auto-scroll, filterable

## Themes

7 built-in themes: Hacker, Gruvbox Dark, Catppuccin Mocha, Catppuccin Latte,
Tokyo Night, Dracula, Nord. Press `T` to cycle. Preference is saved to
`~/.config/yabridge-tui.toml`.

## License

GPL-3.0
