Version 1.0.11 · MIT licensed

Download CrapCleaner

Portable builds for Windows and Linux. No installer, no bundled extras, no account. The binaries are produced by the project's public build workflow from the tagged commit.

Windows

A single portable .exe for 64-bit Windows 10 and 11. Nothing to install and no Python required.

CrapCleaner.exe

Roughly 49 MB. Run it from anywhere, including a USB stick.

Linux

A 64-bit ELF binary that runs on Ubuntu, Debian, Fedora and Arch without a distribution package.

crapcleaner-linux-x86_64

Mark it executable with chmod +x before the first run.

Source

Read it, build it, or change it. Python 3.10, 3.11 and 3.12 are supported and tested on both platforms.

Browse the repository

Source archives are attached to every release.

Looking for an older build, or the full release notes? Every release is listed on GitHub.

Verify

Check what you downloaded

Every release ships a checksums.txt file. Comparing the hash confirms the file arrived intact and matches the published build.

Windows (PowerShell)

Get-FileHash .\CrapCleaner.exe -Algorithm SHA256

Linux

sha256sum crapcleaner-linux-x86_64

Download checksums.txt for the latest release and compare the value for your file.

From source

Run it without a prebuilt binary

The repository ships helper scripts for uv, and works with a plain virtual environment if you prefer one.

With uv

git clone https://github.com/PatrickJnr/crapcleaner.git
cd crapcleaner

# Bootstrap the environment and launch
./scripts/runuv.sh

# Or step by step
uv venv
uv pip install -e .
uv run crapcleaner --gui

With pip

git clone https://github.com/PatrickJnr/crapcleaner.git
cd crapcleaner

python3 -m venv .venv
# activate .venv for your shell
pip install -e .
crapcleaner --gui

Before you run it

Two things worth knowing

Windows may warn you first

The Windows binary is not code-signed, so SmartScreen shows a warning the first time you run it. Signing certificates cost money that this project does not take in. Verify the checksum against the release if you would rather not take that on trust.

Administrator rights are optional

CrapCleaner runs as a normal user. A handful of system categories need elevation and are clearly labelled as such. On Linux it elevates individual commands through pkexec rather than running the whole application as root.

System requirements
Requirement	Windows	Linux
Operating system	Windows 10 or 11, 64-bit	64-bit distribution with glibc
Install step	None, the executable is portable	None, mark the binary executable
Python	Only when running from source (3.10 or newer)	Only when running from source (3.10 or newer)
Network access	Not used	Not used