dvx

dvx is a small, read-only terminal tool for seeing where disk space is going. It starts with the useful part of df: the places on your machine and how much room they have. Open one to see its largest files and directories.

It deliberately stays small. It does not delete files, change files, keep a permanent index, load a visual theme, or try to become a file manager.

Install

Build from source:

git clone https://github.com/saltnpepper97/dvx.git
cd dvx
cargo build --release --locked
install -Dm755 target/release/dvx ~/.local/bin/dvx
install -Dm644 man/dvx.1 ~/.local/share/man/man1/dvx.1

Make sure ~/.local/bin is in your PATH. The manual is then available with man dvx.

Use

dvx                        Open the filesystem overview
dvx "$HOME"                Open a directory directly
dvx --plain                Print a filesystem report
dvx --plain "$HOME"        Print a directory report

When output is piped or redirected, dvx automatically prints the plain report. dvx --help shows the short command reference. The full manual is also in man/dvx.1 and can be read from the source tree with man ./man/dvx.1.

Keys

• Up/Down or j/k: select a row
• Enter or Right: inspect the selected place
• Backspace or Left: go back
• r: measure again
• q or Esc: quit

How it measures

dvx is Linux-first. It reads /proc/self/mountinfo for the filesystem overview and reports allocated disk space while inspecting directories. It never follows symbolic links or crosses into another filesystem during a directory scan. Unreadable places are left alone and counted instead of stopping the scan.

Completed interactive measurements are cached for up to ten minutes under $XDG_RUNTIME_DIR/dvx. This runtime cache is normally cleared when you log out or restart. Cached views are marked in the footer; press r to measure again. Filesystem capacity and free space are always read fresh, and plain reports do not use the cache.

License

dvx is available under the MIT license.