STORAGESHOWERALL(1)

NAME
storageshowerall - the storageshower comprehensive reference (invocation, TUI keybinds, color themes, drill-down, configuration file, alerts)

OVERVIEW
This is the all-in-one storageshower manual, modeled on zshall(1). It concatenates the major sections of the storageshower reference into a single page so you can grep with `/`:

    1. INVOCATION — CLI flags, override precedence, config file path
    2. TUI LAYOUT — header, disk rows, bars, status line, overlays
    3. KEYBINDS — navigation, sort, filter, drill-down, theme editor, help
    4. CONFIG FILE — ~/.storageshower.conf TOML schema
    5. COLOR THEMES — built-in palettes, custom themes, --export-theme workflow
    6. DRILL-DOWN — per-directory scan, async progress, copy-path, sort modes
    7. ALERTS — warn/crit thresholds, terminal bell, status line message
    8. FILES & ENV — config path, env overrides
    9. EXIT CODES & EXAMPLES
    10. SEE ALSO

1. INVOCATION
See storageshower(1) for the per-flag table. All CLI options have a matching key in the config file (long-name → snake_case); CLI flags override the file.

2. TUI LAYOUT
storageshower renders three regions, top to bottom:

    •   Header — ASCII banner, version, current mode, refresh interval.

    •   Disk rows — one row per mount: name (truncated to col width), bar (style configurable), used/total (units configurable), and color-coded percent.

    •   Status line — filter prompt, last alert, paused indicator, sort indicator.

The help overlay (?) and theme-editor overlay (C) modal-cover the disk rows while open.

3. KEYBINDS

  Navigation

j / k / ↓ / ↑
    Scroll the disk list one row.

PgDn / PgUp / Space
    Page-scroll.

Home / End / g / G
    First / last row.

  Sort + filter

s   Cycle sort mode (name → pct → size → name …).

r   Reverse current sort.

/   Open filter prompt. Type to filter rows by mount name. Ctrl+W deletes the previous word; Ctrl+H backspaces. Enter commits, Esc cancels.

  Display

b   Cycle bar style (gradient → solid → thin → ascii).

c   Cycle color palette.

u   Toggle used/total display vs percent-only.

a   Toggle all mounts vs local-only (HDD/SSD).

m   Toggle compact mount names vs full paths.

  Drill-down + actions

Enter
    Drill into the focused mount: spawn a background scan, populate a per-directory size view.

Bkspc / h
    Drill up one level.

y   Copy the focused mount path or drill path to the system clipboard (pbcopy / wl-copy / xclip / xsel).

p   Pause auto-refresh.

  Themes + help

C   Open the theme editor: adjust 6 palette colors interactively, name it, and save into the config file. Press Esc to revert.

T   Open the theme chooser (saved themes + built-ins).

? / h
    Open the help overlay.

q, Esc (top-level)
    Quit. The runtime restores the cooked terminal mode.

4. CONFIG FILE
~/.storageshower.conf is TOML. Example:
    sort = "size"           # name | pct | size
    reverse = false
    local_only = false
    no_virtual = false
    bar_style = "gradient"  # gradient | solid | thin | ascii
    color = "default"
    units = "human"         # human | gib | mib | bytes
    compact_mount = false
    warn_pct = 70
    crit_pct = 90
    refresh_secs = 1
    [[themes]]
    name = "neon"
    colors = ["#05d9e8", "#ff2a6d", "#d300c5", "#39ff14", "#ff073a", "#0d0d1a"]

CLI flags override config keys; per-key precedence is documented in storageshower(1).

5. COLOR THEMES
storageshower ships with ~12 cyberpunk-tuned palettes. Run storageshower --list-colors to enumerate them. To make your own:

    •   Open the theme editor with C, tune 6 colors interactively, name it.

    •   Or hand-edit a [[themes]] block in the config (see 4. CONFIG FILE above).

    •   Switch with --theme NAME or with the T overlay at runtime.

--export-theme prints the current palette as a ready-to-paste TOML block.

6. DRILL-DOWN
Pressing Enter on a mount row launches a background thread that walks the mount, accumulating per-direct-child sizes. While scanning the status line shows the count + total so far; when the scan completes the view switches to the drill page with sortable (s) and reversible (r) entries. Enter drills deeper; h / Bkspc drills back up.

7. ALERTS
A mount crossing warn_pct flashes the status line + sets the row color; a mount crossing crit_pct additionally bells the terminal once per crossing. The bell is suppressed across rescans of the same mount until the percent drops back below warn and then re-crosses.

8. FILES & ENV

'~/.storageshower.conf'
    Default config file. Use --config PATH to point at an alternate.

SS_NO_COLOR
    If set, suppress ANSI color in the TUI (degrade to monochrome).

CLIPBOARD_CMD
    Override the auto-detected clipboard tool.

9. EXIT CODES & EXAMPLES

0   Clean quit via q / Esc.

1   Argument-parse error (bad -s, -b, or -u value).

2   TTY can't be put into raw mode (typically: stdin not a terminal).

Example invocations are in storageshower(1).

10. SEE ALSO
storageshower(1), ncdu(1), du(1), df(1), sysinfo(5), iftoprs(1), iftoprsall(1), lsofrs(1), lsofrsall(1)