syz: an interactive file size viewer

syz (pronounced "size") is a small cross-platform Rust command-line tool for exploring file and directory sizes. It recursively scans directories without following symbolic links and presents a compact interactive view that makes it easier to spot large files and folders.

What it is

syz scans a directory tree and shows:

• A sorted list of top-level entries and their sizes
• A horizontal bar map that visualizes the relative sizes of those entries

syz runs as an interactive terminal viewer. While navigating:

• Press the down arrow to move the cursor to the next item (the largest item may be hidden to make smaller items easier to compare).
• Press the right arrow to drill into the selected directory (no action if the selection is a file).

Installation

Prerequisites:

• Rust and Cargo installed (https://www.rust-lang.org/tools/install)

Install from crates.io:

cargo install syz

Build and install from source:

git clone <repository-url>
cd syz
cargo install --path .

Or build a release binary:

cargo build --release
# binary will be in target/release/syz

Usage

Show help and available options:

syz --help

Run the interactive viewer on the current directory:

syz

syz always starts from the current working directory, so cd into the directory you want to inspect before running it.

Example workflow:

1. Run syz at a top-level directory.
2. Use the arrow keys to navigate and drill down into large directories.
   • Right key to drill down to the next folder.
   • Left key to go up a folder.
   • Up and down to select files and folders. Since large files can dominate the size graphic, you can press down to exclude larger items and compare smaller ones more easily.
3. Use --help for non-interactive flags and options provided by the binary.

Building from source

Build the project locally:

cargo build

Run it from the current directory:

cargo run

Install the binary with Cargo:

cargo install syz

Contributing

• Please open issues for bugs and feature requests.
• Fork the repository, make changes on a branch, and submit a pull request.
• Ensure new code includes tests where practical and maintain code formatting with cargo fmt.

License

This project is licensed under the MIT License — see the LICENSE file for details.