Visual disk space dashboard

See exactly where your disk space goes with QDirStat

QDirStat turns complex directory trees into a sortable workspace and visual treemap, helping users identify large files, compare folders and plan safer storage cleanup.

Open sourceReadable source archive
Storage focusedClear directory analysis
Visual analysisTree plus treemap view
Workspace overview

What is QDirStat?

QDirStat is a graphical directory statistics tool that combines a detailed folder tree, file-size sorting, type summaries and a treemap so storage problems can be investigated from one interface.

Analysis module

Turn raw file sizes into practical decisions

Desktop utility

Instead of reading command-line totals one folder at a time, you can scan a directory, expand its hierarchy and inspect the largest areas visually. This is useful when a home folder, development machine, server mount or archive drive is unexpectedly full.

QDirStat is most useful as an investigation tool. It helps identify candidates for cleanup, but the user still needs to understand what each file belongs to before removing it.

Tree viewNavigate directories
TreemapCompare large items
CleanupRun deliberate actions
Directory analysis dashboard illustration
Dashboard capabilities

QDirStat features for storage analysis

The interface is designed to move from a high-level disk overview to a specific file or directory without losing context.

01

Sortable directory tree

Review folders and files by size, item count or path, then expand the hierarchy to understand which subdirectories contribute most to the total.

02

Visual treemap

Large blocks immediately reveal storage-heavy files, while color grouping helps identify patterns across extensions and content types.

03

File type statistics

Compare how much space common extensions consume across the scanned directory.

04

Custom cleanup actions

Configure deliberate commands for recurring maintenance tasks while keeping control in the user’s hands.

05

Cache file support

Open previously collected directory data without repeating a full live scan.

06

Mounted storage review

Inspect readable local drives, removable media and mounted remote paths.

07

Qt desktop interface

Use a familiar multi-panel layout across many Linux desktop environments.

08

Source availability

Build from editable source code when a distribution package is unavailable or outdated.

Four-stage workflow

How QDirStat works

The application separates scanning, analysis and cleanup so you can review storage information before making any changes.

STEP 01

Select a location

Choose a directory, mounted filesystem or supported cache file.

STEP 02

Scan the tree

QDirStat reads accessible entries and calculates directory totals.

STEP 03

Inspect patterns

Use sorted columns, type statistics and the treemap to locate large items.

STEP 04

Act carefully

Verify the full path and purpose before applying a cleanup action.

Platform status

QDirStat compatibility

QDirStat is best treated as a Linux and Unix-like desktop utility. Other environments may require additional layers rather than a native one-click setup.

Ubuntu / DebianRepository packages and source builds are common options.Recommended
Arch LinuxCheck official repositories first, then evaluate AUR variants carefully.Supported
FedoraDistribution packages are available in supported releases.Supported
DockerCommunity images can expose a remote GUI with mapped storage.Advanced
WindowsNo simple native Windows workflow is provided by this source archive.Not native
Practical workflows

Where QDirStat is useful

Use the dashboard when you need more detail than a single free-space number can provide.

A

Home directory cleanup

Find oversized downloads, caches, media folders and forgotten archives before a laptop runs out of space.

B

Developer workstations

Compare build outputs, dependency trees, virtual environments and container data that quietly accumulate over time.

C

Server mount review

Inspect a mounted data path from a graphical workstation when permissions and network performance allow it.

D

Archive planning

Identify the largest project folders before moving data to slower storage or creating a backup schedule.

E

File type investigation

See whether videos, images, logs, package caches or disk images dominate a directory.

F

Repeat reporting

Use cache files to review large directory trees without scanning the live filesystem every time.

Installation dashboard

QDirStat installation and setup

Use a distribution package where possible. The source ZIP in the download section is intended for users comfortable with build tools and Qt development dependencies.

Ubuntu / Debian package
sudo apt update
sudo apt install qdirstat
Fedora package
sudo dnf install qdirstat
Arch package check
pacman -Ss qdirstat
sudo pacman -S qdirstat
Source workflow outline
unzip qdirstat-master.zip
cd qdirstat-master
# Read the included build documentation
# Install the required Qt and compiler packages
# Build in a separate directory
Launch verification
qdirstat
Source archive

Download QDirStat

Download the provided upstream source-tree ZIP. This is editable source code rather than a one-click installer, so Linux build dependencies may be required.

FormatZIP source archive
PlatformLinux / Unix-like
LicenseOpen-source project
Download QDirStat
QDirStat source download dashboard illustration
Before cleanup

QDirStat safety notice

Disk usage tools can reveal important system and application data. Treat every cleanup action as a separate decision from the scan itself.

!

Inspect first, delete second

Confirm the full path, file owner and application purpose. Back up irreplaceable data, prefer application-provided cleanup controls and avoid elevated privileges for routine scans. A large file is not automatically unnecessary.

Balanced assessment

QDirStat pros and cons

The tool is strong for detailed Linux storage analysis, but its source-focused and desktop-oriented workflow may not suit every environment.

Pros

  • Detailed directory tree with visual treemap
  • Useful file-type statistics and size sorting
  • Open, editable source code
  • Works across many Linux desktop environments
  • Cache support for repeat or remote analysis

Cons

  • Not a simple native Windows application
  • Source builds require development dependencies
  • Large or remote trees can take time to scan
  • Cleanup actions require careful configuration
  • Distribution package versions may differ
Package context

QDirStat release information

The download on this page follows the project’s main source branch. Distribution repositories may package a numbered release on their own schedule.

Current upstream releaseVersion 2.0 is the latest numbered release identified during this site build.
Provided downloadMain-branch source ZIP from the upstream repository.
Package differencesUbuntu, Arch and Fedora package versions can differ by distribution release.
Recommended update pathUse the same package manager or build method used for the original installation.
VerificationRead the archive documentation and inspect the extracted source before building.
Problem dashboard

QDirStat troubleshooting

Start with the selected path, permissions and storage type before changing the application or rebuilding from source.

Scan is very slow

Test a smaller local directory, unmount unnecessary network paths and check whether the storage device is busy or sleeping.

Permission warnings

Run as a normal user and scan only readable locations. Use elevated access for a specific protected path, not as a default.

Totals differ from system tools

Remember that reserved blocks, snapshots, deleted-open files and metadata may not appear as ordinary directory entries.

Application does not launch

Check the terminal output, Qt runtime availability and whether the installed package matches your distribution release.

Learning center

QDirStat guides

Continue with focused installation, compatibility, cleanup and troubleshooting articles.

QDirStat installation guide illustration
Setup

How to install QDirStat safely

Choose between repository packages and a source build without mixing update methods.

Read installation guide
Finding large files with QDirStat illustration
Usage

Find large files with QDirStat

Move from a treemap block to the exact directory path and verify it before cleanup.

Read large-file guide
QDirStat troubleshooting dashboard illustration
Fixes

Resolve common QDirStat problems

Troubleshoot permissions, slow scans, launch errors and unexpected storage totals.

Read troubleshooting guide
View All QDirStat Guides
Help dashboard

Frequently asked questions about QDirStat

Twenty focused answers covering installation, compatibility, scanning, safety and common problems.

QDirStat is a graphical disk usage analyzer that scans a directory tree, sorts folders by size and presents storage use through lists and a treemap. It helps you find large files, understand where space is being consumed and plan cleanup work more carefully.

Yes. QDirStat is distributed as open-source software. This site provides an independent guide and a source archive download path; it is not the official project website. Review the included license and source files before building or redistributing the software.

Yes. Linux is the primary environment for QDirStat. It is available through several distribution repositories and can also be built from source when the required Qt and development packages are installed.

QDirStat is not primarily a native Windows utility. Advanced users may experiment through Unix-like layers, containers or remote GUI setups, but that adds complexity. For a straightforward Windows experience, a Windows-native disk usage analyzer is usually easier.

Yes. Ubuntu users can normally install a packaged build from the distribution repository. Package versions may lag behind the newest upstream source, so choose between repository stability and source compilation based on your needs.

Arch users should first check the official repositories. If the desired package or variant is not available there, an AUR workflow may be considered. Always inspect PKGBUILD files and build in a clean environment before installation.

Yes, community-maintained container images can expose QDirStat through a browser or remote desktop layer. You must map only the directories you intend to inspect and choose read-only mounts when deletion or modification is not required.

The treemap represents files and directories as colored rectangles. Larger rectangles use more storage. Color grouping can help distinguish file types, while selecting a block lets you connect the visual area with its location in the directory tree.

Yes, provided the drive is mounted and your user account has permission to read it. For removable or network storage, scanning speed depends on the connection, file count and filesystem response time.

No. Scanning is separate from cleanup. Deletion or cleanup actions require a deliberate user command. Review the selected path, confirm backups and avoid running with elevated privileges unless a protected directory genuinely needs inspection.

A scan can slow down on directories with many small files, network mounts, permission errors or sleeping disks. Wait for active storage to respond, exclude unnecessary mount points and test a smaller directory to separate a performance issue from a permissions problem.

Missing folders usually indicate insufficient permissions, an unmounted path, an excluded filesystem or a scan started from a narrower directory. Check the selected root and read permissions before repeating the scan.

QDirStat totals visible files it can read, while filesystem tools can include reserved blocks, deleted-but-open files, metadata, snapshots and other allocation details. The figures answer different questions, so a difference does not automatically indicate an error.

Start with the smallest relevant directory, avoid slow network paths, close heavy disk workloads and use cache files for repeat analysis where appropriate. Scanning as a regular user also avoids traversing protected areas you may not need.

Cache files store a previously collected directory tree so QDirStat can reopen the analysis without reading every file again. They are useful for remote systems, scheduled scans or large trees that change slowly.

Root access provides broad visibility but also increases the consequences of a cleanup mistake. Prefer a normal account. Use elevated access only for a specific protected path, and avoid configuring destructive cleanup actions during a privileged session.

The mount may use permissions, access control lists, container restrictions or network credentials that block your account. Confirm the mount is active, then test read access from the shell before troubleshooting QDirStat itself.

Use QDirStat for identification first. Verify the full path, understand the owning application, back up irreplaceable data and remove files through the application when it manages its own database or cache. Never delete a large item only because it appears at the top.

It can analyze remote storage that is mounted as a readable filesystem, but performance may be limited by latency and file count. A cache generated close to the data can be more efficient than repeatedly scanning over a slow connection.

Extract the archive, read the project documentation, install the stated build dependencies and compile it in a user-owned working directory. The provided ZIP is source code, not a one-click Windows installer, so a development toolchain may be required.