diskbloom

KO | EN

gitlite — search

#react #ai #typescript #golang #rust #deep-learning #nodejs #java #awesome #kubernetes #awesome-list #mcp #openai #open-source

(★ 35)

🌸 a pastel treemap TUI that shows what's eating your disk

diskbloom 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ✿ diskbloom

### see what's eating your disk, in bloom

*A pastel, WizTree-style treemap disk visualizer that lives in your terminal.*

[![Latest Release](https://img.shields.io/github/v/release/Zingzy/diskbloom?color=f2a7c3)](https://github.com/Zingzy/diskbloom/releases)
[![CI](https://github.com/Zingzy/diskbloom/actions/workflows/ci.yml/badge.svg)](https://github.com/Zingzy/diskbloom/actions/workflows/ci.yml)
[![Go Report Card](https://goreportcard.com/badge/github.com/Zingzy/diskbloom)](https://goreportcard.com/report/github.com/Zingzy/diskbloom)
[![License](https://img.shields.io/badge/license-Apache--2.0-b7bdf8)](https://raw.githubusercontent.com/Zingzy/diskbloom/main/LICENSE)

*Theme: Catppuccin Mocha · Font: JetBrains Mono · Recorded with [VHS](https://github.com/charmbracelet/vhs)*

</div>

## Features

- 🌸 **Pastel treemap**: every file type gets its own hue, ranked by size so the types *you* have are the most distinct
- 🪆 **Nested mosaic**: regions are recursively subdivided (WizTree-style), so a big folder reads as a map of its contents, not an empty box
- ⚡ **Fast concurrent scanning**: bounded-parallel walker measuring real on-disk allocation, with hardlink dedup so shared data counts once
- 🌳 **Dual-pane tree view**: a WizTree-style tree with size bars alongside the map, plus an extension color legend
- 🗑️ **Safe delete**: <kbd>ctrl+x</kbd> sends to Trash by default; permanent delete always requires typing it out
- 👀 **Quick Look & open**: <kbd>space</kbd> previews (macOS), <kbd>enter</kbd> opens files in their default app
- 🖱️ **Mouse included**: click to select, click again to open; scroll either pane
- 🪶 **Single static binary**: Go all the way down, no dependencies

## Installation

> diskbloom supports **macOS and Linux**. A truecolor terminal is recommended for the full palette.

### Homebrew (recommended)

```sh
brew install Zingzy/tap/diskbloom
```

### Go

```sh
go install github.com/Zingzy/diskbloom@latest
```

### Binaries

Prebuilt binaries for macOS (arm64/amd64) and Linux (amd64/arm64) are on the
[releases page](https://github.com/Zingzy/diskbloom/releases).

<details>
<summary>Build from source</summary>

Requires Go 1.26+.

```sh
git clone https://github.com/Zingzy/diskbloom
cd diskbloom
go build -o diskbloom .
```

</details>

## Usage

```sh
diskbloom            # scan the current directory
diskbloom ~/Movies   # scan a specific path
```

Reading the map:

- **Area is size on disk**: a tile twice as big takes twice the space (allocated blocks, like WizTree, so it matches what deleting actually frees)
- **Color is file type**: the legend (bottom-left) maps extensions to hues; folders take the color of their dominant content
- **Nesting is structure**: the mosaic inside a region is that folder's contents, three levels deep
- **Brightness is share**: bigger slices of the parent glow brighter, so the heavy stuff pops

## Keybindings

Press <kbd>?</kbd> inside diskbloom for the full list.

| Key | Action |
| --- | --- |
| <kbd>←↑↓→</kbd> / <kbd>hjkl</kbd> | Move spatially between regions |
| <kbd>enter</kbd> | Drill into a folder · open a file |
| <kbd>esc</kbd> / <kbd>backspace</kbd> | Go up a level |
| <kbd>space</kbd> | Quick Look preview (macOS) |
| <kbd>ctrl+x</kbd> | Delete: <kbd>enter</kbd> Trash · <kbd>shift+enter</kbd> permanent |
| <kbd>tab</kbd> | Switch focus between treemap and tree pane |
| <kbd>t</kbd> | Toggle the tree pane |
| <kbd>m</kbd> | Toggle the extension color map |
| <kbd>r</kbd> | Rescan |
| <kbd>q</kbd> / <kbd>ctrl+c</kbd> | Quit |

## How it works

A concurrent `os.ReadDir` walker measures on-disk allocation and dedups
hardlinks by `{dev, ino}` (`internal/scan`); the
[squarified treemap algorithm](https://www.win.tue.nl/~vanwijk/stm.pdf) with
cell-aspect correction keeps tiles visually square despite terminal cells being
~2× taller than wide (`internal/treemap`); a renderer fuses adjacent rounded
borders into single lines and recursively subdivides regions
(`internal/render`); per-extension hues are stepped by the golden angle so the
palette spreads itself out (`internal/theme`). Glued together with
[Bubble Tea v2](https://charm.land).

## Alternatives

- [WizTree](https://diskanalyzer.com/) (Windows GUI), the inspiration for the nested treemap and color map
- [diskonaut](https://github.com/imsnif/diskonaut) (Rust), terminal treemap whose spatial navigation this follows
- [gdu](https://github.com/dundee/gdu) (Go), ncdu-style list and the reference fast scanner
- [dust](https://github.com/bootandy/dust) (Rust), du with a bar chart
- [dua-cli](https://github.com/Byron/dua-cli) (Rust), interactive list-based analyzer
- [ncdu](https://dev.yorhel.nl/ncdu) (C/Zig), the classic

## Roadmap

- [ ] macOS `getattrlistbulk` fast path (batches name+size+type per syscall)
- [ ] live-updating treemap that grows while scanning
- [ ] aggregated "small files" tile + zoom, instead of hiding tiny entries
- [ ] half-block (`▀`) rendering mode for double-resolution density

## Contributing

Issues and pull requests are welcome! To report a bug, simply
[open a new issue](https://github.com/Zingzy/diskbloom/issues/new).

## License

[Apache-2.0](LICENSE)

---

Built with 🌸 and [Bubble Tea](https://github.com/charmbracelet/bubbletea) ·
[Lip Gloss](https://github.com/charmbracelet/lipgloss) ·
[VHS](https://github.com/charmbracelet/vhs)

</div>

<h6 align="center">
<img src="https://avatars.githubusercontent.com/u/90309290?v=4" height=30 title="zingzy Copyright">
<br>
© zingzy . 2026

diskbloom

diskbloom 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

diskbloom

diskbloom 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README