// STORAGESHOWER — DISK MATRIX HUD

Install

# Homebrew (recommended)
brew tap MenkeTechnologies/menketech
brew install storageshower

# crates.io
cargo install storageshower

# from source
git clone https://github.com/MenkeTechnologies/storageshower
cd storageshower && cargo build --release
./target/release/storageshower

Runs on macOS and Linux. Rust ≥ 1.85 (2024 edition) to build from source. LTO + strip in release profile — lean single binary.

Quick tour

storageshower                            # default palette, all filesystems
storageshower --color purple -b ascii    # purple palette + ascii bars
storageshower -s pct -R                  # sort by usage%, descending
storageshower -l --no-virtual            # local physical disks only
storageshower -u gib -w 60 -C 85         # GiB units, warn 60%, crit 85%
storageshower --theme neonpink           # activate a custom theme from config
storageshower --list-colors              # preview every builtin palette
storageshower --export-theme --color blue # dump a builtin palette as TOML
storageshower --config /tmp/ss.conf      # use an alternate config file

CLI flags override config. Every --flag has a paired --no-flag inverse so either direction can be forced from the command line. Config lives at ~/.storageshower.conf (TOML). Note: --color has no short alias — -c is reserved for --config.

Subsystems

Builtin color palettes

30 hand-tuned cyberpunk palettes ship in storageshower. Cycle with c for the popup chooser (mouse + scroll), or pin one from the CLI with -c <name>. Use --list-colors to see all of them rendered.

Ten ready-to-copy custom-theme TOMLs also ship under themes/ as starting points: acid_rain, data_stream, ghost_wire, ice_breaker, neon_sprawl, red_sector, rust_belt, sakura_den, solar_flare, synth_wave. Each file is a single [custom_themes.<name>] block — paste one into your config and select it with active_theme or --theme <name>.

CLI flags

Sorting

Display

Thresholds & columns

System

Keybindings

General

Navigation

Sort & filter

Display toggles

Disk ops

Drill-down mode

Filter edit mode (after /)

Theme editor (C)

Mouse input

Config file

The config lives at ~/.storageshower.conf and is written from the default template (storageshower.default.conf) on first run if it does not yet exist. The theme editor and theme chooser save changes back to it on apply. Keys map directly to the serialized Prefs struct (TOML via serde); custom palettes are merged from [custom_themes.<name>] blocks and selected with active_theme or --theme NAME. Enum-valued keys are serialized in their TitleCase form. Example:

sort_mode     = "Pct"        # Name | Pct | Size
sort_rev      = true
show_local    = false        # only local disks (HDD/SSD)
show_all      = true         # include virtual filesystems
bar_style     = "Gradient"   # Gradient | Solid | Thin | Ascii
color_mode    = "Purple"     # one of the 30 builtin palettes
unit_mode     = "Human"      # Human | GiB | MiB | Bytes
thresh_warn   = 70           # cycle: 50 -> 60 -> 70 -> 80
thresh_crit   = 90           # cycle: 80 -> 85 -> 90 -> 95
refresh_rate  = 1            # seconds; cycle: 1 -> 2 -> 5 -> 10
show_bars     = true
show_border   = true
show_header   = true
show_used     = true
show_tooltips = true
compact       = false
full_mount    = false
col_mount_w   = 0            # 0 = auto
col_bar_end_w = 0            # 0 = auto
col_pct_w     = 0            # 0 = auto
active_theme  = "neonpink"
bookmarks     = []

[custom_themes.neonpink]
blue          = 199
green         = 46
purple        = 201
light_purple  = 213
royal         = 196
dark_purple   = 161

A custom theme is six 256-color terminal indices: blue, green, purple, light_purple, royal, dark_purple. Set active_theme (or pass --theme) to a [custom_themes.<name>] key to activate it. Bookmarked mounts persist in the bookmarks array and pin to the top of the list across runs.

Inverse --no-flag CLI variants force-override the corresponding config field in either direction — useful for one-off invocations that diverge from the saved baseline (e.g. --no-tooltips defeats show_tooltips = true without rewriting the file). The shipped storageshower.default.conf in the repo root documents every key inline with comments and a full flag/keybinding reference.

Platform notes

• macOS — disk I/O via IOKit IOBlockStorageDriver byte counters, device-to-mount mapping via getmntinfo. SMART via diskutil info (parses the SMART Status: line). Battery via IOKit, local IP from getifaddrs.
• Linux — disk I/O via /proc/diskstats (sector counters, scaled by sector size), mount mapping via /proc/mounts. SMART status read from /sys/block/<dev>/device/state. Battery from /sys/class/power_supply/, local IP via getifaddrs.
• No root required for any feature. Network FS latency is a userspace read_dir probe with a 2 s timeout.

Worked examples

Inverse forms (--virtual, --no-reverse, --no-local, --bars, --header, …) let a one-off invocation override a saved config field without rewriting the file.

Troubleshooting

• No disk I/O numbers — throughput overlays (▲▼) appear only when a mount has measurable read/write delta between refresh ticks. An idle disk shows no overlay. On macOS the IOKit device map and on Linux /proc/diskstats must resolve the mount to a base device; loopback / overlay / pseudo devices may not map.
• No SMART badge — SMART is probed per base device. Network, virtual, and removable mounts that don't expose SMART (or report an unknown state) render no health glyph rather than a false one.
• Network mount latency badge missing — the probe times out after 2 s; an unreachable mount returns no badge instead of hanging the UI. Only the recognized network filesystem types are probed.
• Blank mount rows — disk enumeration omits entries with an empty mount path, so the TUI never paints a blank row even when the OS reports an odd mount-table entry.
• Config not loading — a malformed ~/.storageshower.conf falls back to defaults silently rather than erroring out. Enum keys must use TitleCase values (e.g. color_mode = "Purple", not "purple"); the on-CLI --color purple uses the kebab/lower form.
• No root required — every probe (I/O, SMART, network latency) is a userspace read; storageshower never needs elevated privileges.

Source & links

• Source — GitHub repo
• Crate — crates.io (cargo install storageshower)
• Homebrew — MenkeTechnologies/menketech tap
• API docs — docs.rs
• Issues — issue tracker
• README — full README on GitHub
• Engineering report — report.html (source distribution, test surface, dependency tree, key design decisions)