TiloBox
Back to directory
dust project preview

dust

A command-line disk usage viewer that ranks directory trees and shows where storage is being consumed.

LicenseApache-2.0
GitHub stars12.2k
Last commit1 weeks ago
Tags6 topics
CliRustOpen SourceDisk UsageFilesystemDatabase
Overview

Why consider dust?

Dust is an open-source terminal disk usage analyzer written in Rust that provides an intuitive graphical breakdown of directory sizes. It presents hierarchical storage usage without requiring piped sorting commands.

Guided learning

Learn dust by building

Practical setup notes, real use cases, and copy-ready examples in one focused guide.

4 min read 4 sections
In this guide4 sections

Navigating Disk Space with Dust

Traditional command-line systems rely on the du tool to report storage consumption, but raw outputs frequently overwhelm terminal screens with unformatted line items. Dust solves this administrative challenge by combining terminal-friendly visualization with high-performance directory traversal. Dust is a more intuitive disk usage analyzer implemented in Rust as a modern alternative to the standard du utility. Instead of requiring complicated pipelines, the tool instantly calculates hierarchical storage weights and displays them using responsive terminal graphics.

System administrators often find themselves piping disk analysis output through multiple text manipulation tools just to isolate storage bottlenecks. The tool provides an immediate visual overview of directory space consumption without requiring users to pipe output into sort or head commands. By prioritizing significant directories automatically, Dust Documentation highlights critical consumption points immediately upon execution.

How Dust Analyzes and Displays Storage Hierarchies

Standard disk inspection tools treat every directory entry equally, generating excessive scrolling across nested file systems. Dust automatically lists the largest subdirectories and files sized to fit terminal height while intelligently recursing down the directory hierarchy. According to the Dust Project README, this automatic terminal budgeting ensures that operators see the top space consumers on screen without manual depth filtering.

To make complex trees easy to read at a glance, the utility pairs proportional size bars with tree lines. The visual bars communicate disk usage and structural hierarchy where distinct shades of grey identify parent and child folder relationships. As detailed in the Official Repository, this visual hierarchy helps operators immediately distinguish isolated large files from directories containing numerous cumulative assets.

Large development repositories and build directories often accumulate thousands of negligible artifacts that obscure meaningful storage patterns. Dust keeps command output concise and focused on high-impact items by filtering out clutter and highlighting the largest entries across deep trees. Information on the Dust Repository notes that this design choice eliminates noise while accurately surfacing heavy dependencies and temporary caches.

Accurate capacity planning requires precise accounting for linked files and deduplicated storage blocks. When calculating storage consumption across complex directory structures, Dust avoids counting hard links multiple times unless explicit apparent size flags are specified. The Dust Repository Overview highlights that this default behavior reflects actual underlying disk block usage rather than inflated theoretical maximums.

Installing and Running Dust

Getting started with Dust requires minimal environmental configuration across standard workstation environments. The official automated installation script enables rapid deployment across Linux, macOS, and Windows operating systems. Operators can review the verified installation script directly on the Official README and execute the recommended command:

bash
1curl -sSfL https://raw.githubusercontent.com/bootandy/dust/refs/heads/master/install.sh | sh

Users can also install Dust through diverse distribution packaging channels such as Cargo, Homebrew, DNF, Snap, and Scoop. The software is actively maintained with official binaries packaged and distributed through release version v1.2.5. Details regarding packaged distributions and platform artifacts are accessible via Dust Release v1.2.5.

Customizing Output with Configuration Files

Rather than repeatedly entering CLI parameters on every invocation, operators can define default display preferences. Configuration parameters can be persistently stored in standard TOML files located at either the XDG config directory or the user home directory. As documented in the Dust Source Repository, keys correspond directly to kebab-case command line flags for predictable formatting.

The following official example demonstrates basic formatting directives available in the project template file at Dust Config Template:

toml
1# Print tree upside down (biggest highest)
2reverse=true
3
4# Subdirectories will not have their path shortened
5display-full-paths=true
6
7# Use file length instead of blocks
8display-apparent-size=true
9
10# No colors will be printed
11no-colors=true
12
13# No percent bars or percentages will be displayed
14no-bars=true

Licensing and Governance

When evaluating system management utilities for infrastructure deployment, licensing terms determine organizational suitability. The project is licensed under the Apache License 2.0 terms allowing free distribution and modification for personal and commercial usage. Full licensing guidelines and distribution stipulations are published in the Dust Project License.

Related tools

More options with a similar category or technology profile.

dust FAQs

dust is listed as a Developer Tools tool on TiloBox. Review the overview, features, and official documentation on this page to decide whether it solves your specific workflow.

Start with the project's GitHub repository for supported installation and deployment instructions. Test the setup with representative data or a small project before rolling it out more widely.

dust is listed under the Apache-2.0 license. Read the complete license text and the project's notices before using, modifying, or distributing the software.

Production readiness depends on your requirements. Review maintenance activity, security practices, documentation, backup and upgrade procedures, and compatibility with your stack; then validate it in a non-production environment.

dust is listed as an alternative to du. Compare the core workflow, deployment model, integrations, and licensing against your must-have requirements before switching.