STORAGESHOWER(1)

NAME
storageshower - cyberpunk disk usage TUI (ratatui + sysinfo, drill-down + theme editor)

SYNOPSIS
storageshower [OPTIONS]

DESCRIPTION
storageshower is a real-time disk-usage TUI written in Rust. It enumerates mounted disks via sysinfo(5), renders a colored bar per disk in a ratatui(3rs) terminal UI, and supports drill-down per directory, live filtering, color themes (built-in + user-editable), and configurable warning / critical thresholds.

The UI updates at the --refresh interval (default 1 second) until you press q. All CLI flags have a matching --no-flag inverse so a runtime config in '~/.storageshower.conf' can be overridden per-invocation.

OPTIONS

  SORTING

-s, --sort MODE
    Sort disk entries. MODE is one of name, pct, or size (default size).

-R, --reverse
    Reverse the sort order.

-l, --local-only
    Show only local disks (HDD / SSD), hiding network mounts.

--no-virtual
    Hide virtual filesystems (tmpfs, devfs, devtmpfs, proc, sysfs, etc.).

  DISPLAY

-b, --bar-style STYLE
    Bar visualization style: gradient, solid, thin, or ascii.

--color   PALETTE
    Color palette name (default, green, blue, purple, ...). See --list-colors for the full set.

--list-colors
    Print every built-in color scheme and exit.

--export-theme
    Print the current palette as TOML and exit. Useful for saving + editing.

--theme   NAME
    Activate a user-defined theme by name (loaded from the config file).

-u, --units MODE
    Unit display: human, gib, mib, or bytes.

-k, --compact
    Compact mount names (trim long paths).

-f, --full-mount
    Show full mount paths (overrides --compact).

--no-bars
    Hide the usage bars (text-only display).

--no-border
    Hide border chrome.

--no-header
    Hide column headers.

--no-used
    Hide the used/total size display.

  THRESHOLDS

-w, --warn PCT
    Warning threshold in percent (default 70).

-C, --crit PCT
    Critical threshold in percent (default 90). Mounts at or above this level also bell the terminal once.

  COLUMNS

--col-mount   WIDTH
    Mount column width (0 = auto).

--col-bar-end   WIDTH
    Bar-end column width (0 = auto).

--col-pct   WIDTH
    Percentage column width (0 = auto).

  SYSTEM

-r, --refresh SECS
    Data refresh interval in seconds (default 1).

-c, --config PATH
    Alternate config file path (default '~/.storageshower.conf').

-h, --help
    Show built-in help and exit.

-V, --version
    Show version and exit.

KEYBINDS
While the TUI is running:

    •   q, Esc — quit

    •   j / k — scroll the list

    •   s — cycle sort mode

    •   r — reverse sort

    •   b — cycle bar style

    •   c — cycle color palette

    •   u — toggle used/total display

    •   a — toggle all/local mount view

    •   m — toggle compact / full mount paths

    •   / — enter filter prompt (Ctrl+W deletes word, Ctrl+H backspaces)

    •   p — pause auto-refresh

    •   ? — open the help overlay

EXAMPLES
Purple palette with ASCII bars:

    storageshower --color purple -b ascii

Sort by usage %, reversed:

    storageshower -s pct -R

Local physical disks only, hide virtual:

    storageshower -l --no-virtual

GiB units with stricter thresholds:

    storageshower -u gib -w 60 -C 85

Use an alternate config:

    storageshower --config /tmp/ss.conf

FILES

'~/.storageshower.conf'
    Default config file (TOML). All CLI flags have matching keys; CLI overrides.

EXIT STATUS
storageshower exits 0 on a clean quit (q / Esc), 1 on argument-parse errors, and 2 if the TTY can't be put into raw mode.

SEE ALSO
storageshowerall(1), ncdu(1), du(1), df(1), sysinfo(5), iftoprs(1), lsofrs(1)

AUTHOR
MenkeTechnologies <https://github.com/MenkeTechnologies>

BUGS
Report at 'https://github.com/MenkeTechnologies/storageshower/issues'.