diskbloom — Disk Management

Disk management tool that visualizes disk usage as a treemap to quickly find large folders and files.

Basic Information

What is this program?

diskbloom is a tool that visualizes disk usage in a treemap format. Instead of the text output of the du command, it represents folder and file sizes as rectangular areas, allowing you to see at a glance where the most capacity is being used.

When a server disk is full, finding the culprit by combining du and find is cumbersome. diskbloom automates this process: click the largest rectangle in the treemap to drill down into that folder and quickly find the cause.

What problems does it solve?

• (In low disk space response, 'When the disk is full and you don't know what is using the most space', 'The largest rectangle in the treemap immediately shows the cause of space usage.')
• (In log cleanup, 'When you need to understand the capacity distribution of a log folder', 'You can visually identify large log files in the per-folder treemap.')
• (In capacity planning, 'When tracking disk usage trends', 'You can compare treemaps from different times with the snapshot feature to see usage changes.')

Key Features

Treemap Visualization

Represents folder and file sizes as rectangular areas

• Use case: When you need to quickly understand disk usage
• Result: Find the cause location much faster than with a text list
• Limitations: If there are too many files, the detailed rectangles can become small.

Drill-down

Click a large rectangle to zoom into that folder

• Use case: When narrowing down the culprit folder
• Result: Trace the cause of space usage step by step
• Limitations: Rendering can become slow when zooming into deeply nested directories.

Snapshot Comparison

Save a treemap at a specific point in time and compare it later

• Use case: Tracking capacity changes
• Result: Visually see which folders have grown
• Limitations: Storing snapshots can increase disk usage.

CLI and Web UI

Scan and export with the CLI, and visualize interactively with the web UI

• Use case: Use on both servers and local machines
• Result: The CLI is suitable for automation, and the web UI for exploration
• Limitations: The web UI requires a browser.

Installation and Usage

Linux (binary)

Download and install the official binary.

curl -fsSL https://diskbloom.tools/install.sh | sh
diskbloom --version

Linux (source)

Build from source with Go 1.21+.

git clone https://github.com/diskbloom-dev/diskbloom
cd diskbloom
go build -o diskbloom ./cmd/diskbloom
sudo mv diskbloom /usr/local/bin/

macOS

Use Homebrew.

brew install diskbloom

Real-world Examples

Scan and Treemap Generation

Scan the current directory and generate a treemap.

$ diskbloom scan /var/log --output treemap.png

[scan] /var/log — 847 files, 23.4 GB total
[scan] largest: nginx/access.log (4.2 GB)
[scan] largest dir: journal/ (12.1 GB)
[output] treemap.png saved (1600x900)

Drill Down with the Web UI

Open the web UI to explore the treemap interactively.

$ diskbloom ui /var/log --port 9300
# Open http://localhost:9300 in your browser
# Click a large rectangle → zoom into subfolder → identify the largest file

Save and Compare Snapshots

Save snapshots and compare them later.

$ diskbloom snapshot /var/log --save before.json
# ... after cleaning up space ...
$ diskbloom snapshot /var/log --save after.json
$ diskbloom compare before.json after.json
# diff: journal/ -8.3 GB, nginx/access.log -3.1 GB

Advantages and Limitations

Advantages

• Treemap visualization greatly speeds up finding the cause compared to text-based du
• Provides both CLI and web UI — suitable for automation and exploration respectively
• Snapshot comparison allows tracking capacity changes
• Go-based, so scanning is fast even on large file systems

Considerations Before Use

• The web UI must be run as a separate process and requires a browser.
• Scanning file systems with millions of files can take several minutes.
• Real-time monitoring (daemon) is not yet supported (scan-based).

Comparison with Similar Programs

Official Resources and Further Reading

• Official website — https://diskbloom.tools/
• Official documentation / knowledge base — https://diskbloom.tools/docs/
• Official downloads — https://diskbloom.tools/downloads
• Release notes — https://diskbloom.tools/changelog
• Source / development resources — https://github.com/Zingzy/diskbloom

Version and supported environment information was checked on the official site as of 2026-10-18. Installation commands may vary depending on your distribution and version, so please also check the official installation documentation.

Actual Execution Screen

Below is a composite example screen created to help understand the usage flow (not an actual execution result). The screen is a composite example and not an actual execution result.

!diskbloom scan and snapshot comparison example: /var/log 23.4GB, 11.4GB freed after cleanup

A server in actual operation

Source (HTML): https://games.aidebatehub.com/programs/apps/diskmgmt/diskbloom.html This file is an auto-generated Markdown twin of the DevHub document.