Installation

Installation

Pre-built binaries are attached to every GitHub Release. As of 0.10.0, ClutterCutter is cross-platform: the release ships both a Windows and a Linux download.

Windows

The easiest way is winget:

winget install StruisICT.ClutterCutter
winget upgrade StruisICT.ClutterCutter   # later, to update

winget uses the portable install type: it copies ClutterCutter.exe (under %LOCALAPPDATA%\Microsoft\WinGet\Packages\...) and registers a cluttercutter alias on PATH, so you can also launch it from a terminal. It's not an MSI — nothing is installed into Program Files and there's no uninstaller entry beyond winget's own.

Or download from the releases page and just run it — the release attaches a single portable ClutterCutter.exe: one self-contained executable with no runtime dependency. It's not an installer; run it directly from wherever you saved it. This is the native Win32 build.

On first run, ClutterCutter offers a one-click UAC relaunch so it can use the NTFS MFT fast path — see Scanning & performance.

SmartScreen / Defender: the binaries are currently unsigned, and ClutterCutter requests administrator rights and reads the raw NTFS volume — behaviour heuristic scanners may warn on. Choose More info → Run anyway. Authenticode signing (SignPath Foundation OSS program) is planned to remove this friction.

Linux

Download ClutterCutter-linux-x86_64.tar.gz from the releases page, extract it, and run the portable GUI — there's no installer:

tar -xzf ClutterCutter-linux-x86_64.tar.gz
./cluttercutter-gui

The tarball (x86_64) contains:

File	Notes
cluttercutter-gui	The portable GUI (eframe/egui).
cluttercutter-cli	Console tool for scanning from a terminal.

The Linux build is a portable eframe/egui frontend that shares the same Rust scan engine as Windows and offers the same features — drive cards, browse/drill-in with breadcrumb, Largest/Oldest files, search, the temp/cache view, and scan-any-folder. It scans with a portable std::fs walker; the faster NTFS-MFT fast path is Windows-only.

macOS

There's no prebuilt macOS binary in Releases, but the portable GUI builds from source on macOS — see Building from source:

cd rust
cargo run --bin cluttercutter-gui

Downloads at a glance

Download	Platform	Notes
ClutterCutter.exe	Windows 10 / 11 (x64)	Native Win32 GUI. Portable, self-contained, no runtime. The winget build.
ClutterCutter-linux-x86_64.tar.gz	Linux (x86_64)	Portable egui GUI (cluttercutter-gui) + cluttercutter-cli. Extract and run.

System requirements

• Windows: 10 / 11 (x64). Administrator is optional but recommended for the fast MFT scan path on NTFS drives.
• Linux: x86_64. Runs unprivileged, using the portable walker.