Diskvu

Diskvu is a Qt-based Linux desktop application for exploring disk usage as an interactive treemap.

Features

• Interactive treemap navigation with free zoom, breadcrumb and tree navigation
• Background refresh and filesystem watching for the active tree
• Search and filter by name, size, date and custom folder marks
• Optional image and video thumbnail generation
• File-type list with aggregate size and item counts
• Customisable themes, file colors, and automatic dark mode switching
• Remote scanning agent to browse remote machines via SSH

Requirements

• CMake 3.21 or newer
• A C++17 compiler
• Qt 6 development packages with:
  • Core
  • Gui
  • Widgets
  • Concurrent
  • Svg
  • LinguistTools
  • Test (for the test suite only)

Debian/Ubuntu:

sudo apt install cmake g++ \
    qt6-base-dev qt6-svg-dev \
    qt6-tools-dev qt6-l10n-tools

Arch Linux:

sudo pacman -S cmake qt6-base qt6-svg qt6-tools

Fedora:

sudo dnf install cmake gcc-c++ \
    qt6-qtbase-devel qt6-qtsvg-devel \
    qt6-qttools-devel qt6-linguist

macOS (Homebrew):

brew install cmake qt6

Build

Configure and build with CMake:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)

On macOS, point CMake at your Qt6 installation first:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_PREFIX_PATH=$(brew --prefix qt6)
cmake --build build --target diskvu -j$(sysctl -n hw.ncpu)

The main app target is produced as diskvu:

./build/diskvu
./build/Diskvu.app   # (macOS)

macOS and Windows builds are currently unsupported but fully functional.

Install

Install system-wide after building:

sudo cmake --install build

Or install to a custom prefix:

cmake --install build --prefix ~/.local

Uninstall with:

sudo cmake --build build --target uninstall

Remote Scanning

Remote scanning via SSH is possible using diskvu-agent. Install the agent on a another system and Diskvu will be able to quickly scan and build a treemap for it.

When adding a remote connection, you'll be given the option to automatically install the agent. You can also copy it manually and specify the path if needed.

Native Builds

By default, the normal cmake build command will create a native diskvu-agent for the current CPU architecture. If these builds don't work (e.g. on an older CPU), try the static builds below.

Static Builds

Scripts are provided to create a static musl build if needed.

scripts/build-agent-static.sh                  # this machine's architecture
ARCH=aarch64 scripts/build-agent-static.sh     # arm64 (x86-64 host needs qemu-user-static + binfmt)
ARCH=x86_64 scripts/build-agent-static.sh      # x86-64
ENGINE=podman scripts/build-agent-static.sh    # pick the container engine

To bundle the agents so the automatic install feature works, specify the directory:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DDISKVU_AGENT_BINARIES_DIR=build/agents
cmake --build build -j$(nproc)
cmake --install build --prefix ~/.local    # agents go to share/diskvu/agents