fileherder

Merged into cleanupx. Lightweight dedupe API kept for compatibility.

v1.0.2 PyPI library + CLI

Install

PyPI pip install cleanupx

PyPI · extras pip install 'fileherder[cli]'

from pathlib import Path
from fileherder import FileHerder

herder = FileHerder()
dupes = herder.find_duplicates(Path("~/Downloads").expanduser())
result = herder.organize(Path("~/Downloads").expanduser())

Features

Duplicate finder

Group identical files and report wasted space so you can decide what to keep.

Organize by type

Sort into code, document, image, video, audio, archive, data, text, and other.

Library API

Import FileHerder in scripts instead of shelling out to something opaque.

Stats helper

Quick totals for file count and size when you are surveying a mess.

Small surface

Focused utilities — not a second operating system for your Downloads folder.

Companion tools

For heavier rename/cleanup workflows, see cleanupx and citewright.