explaingit

dundee/gdu

5,647GoAudience · ops devopsComplexity · 1/5Setup · easy

TLDR

Gdu is a fast command-line disk usage analyzer written in Go that shows what is filling up your hard drive, lets you browse and delete files interactively in the terminal, and supports exporting results for scripting.

Mindmap

mindmap
  root((gdu))
    What it does
      Scans disk usage
      Interactive browser
      Fast parallel scan
    Features
      Arrow key navigation
      Delete files in tool
      JSON export
      Archive browsing
    Filters
      Ignore paths
      File age filter
      File type filter
    Setup
      Single binary
      Docker support
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Quickly find which folders or files are consuming the most disk space on a Linux or macOS machine

USE CASE 2

Browse disk usage interactively in the terminal and delete large files or empty directories without leaving the tool

USE CASE 3

Export a disk usage scan to JSON and compare it against a previous snapshot to track what grew over time

Tech stack

GoDocker

Getting it running

Difficulty · easy Time to first run · 5min
No license information was mentioned in the explanation.

In plain English

Gdu is a command-line tool for finding out what is taking up space on your computer's hard drive or SSD. You run it in a terminal, and it scans a directory and shows you the sizes of everything inside, so you can quickly see which folders or files are the biggest culprits. The tool was built with speed in mind. Because it is written in Go, it can scan multiple parts of the filesystem at the same time, which is especially noticeable on solid-state drives. Spinning hard drives also work fine, just without as large a speed advantage. When you run it normally, it opens an interactive view where you can move through folders with arrow keys, drill into subdirectories, sort by size or name, and delete files or empty directories without leaving the tool. There is also a non-interactive mode that prints results as plain text, which is useful for scripting or piping output to other programs. Gdu has a wide range of filtering options. You can ignore specific paths or patterns, limit results to files newer or older than a given age, include only certain file types, or browse inside zip and tar archives as if they were regular folders. You can export a scan to a JSON file and import it later for comparison, or store analyses in a database to track changes over time. Installation is a single binary download from the releases page, or it can be run inside Docker without installing anything on the host system. A configuration file in your home directory can save your preferred defaults so you do not have to retype common flags each time.

Copy-paste prompts

Prompt 1
I'm running out of disk space on my Linux server. Show me the gdu commands to scan the root directory, sort by size, and drill into the biggest folders.
Prompt 2
How do I run gdu inside Docker on a host machine so I can analyze disk usage without installing anything on the server?
Prompt 3
I want to script disk usage checks with gdu. How do I run it in non-interactive mode and pipe the output to find directories over 10GB?
Prompt 4
How do I configure gdu with a config file to always ignore the /proc and /sys directories and show sizes in gigabytes by default?
Open on GitHub → Explain another repo

← dundee on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.