Image Cleanup
Find duplicate images and convert images to smaller WebP files. Image Cleanup
provides the cleanup-cli command and an optional GTK application for Linux.
Features
- Find visually matching images using structural and color signatures, keeping the copy with the highest resolution and using file size to break ties.
- Convert images to WebP while preserving pixel dimensions, replacing sources only when the validated output is smaller.
- Preview changes with dry runs before enabling deletion or replacement.
- See results and storage savings as work completes, with configurable worker and memory limits.
Screenshots
Find duplicate images |
Convert images to WebP |
Installation
Requires Python 3.12 or newer. Install the command-line package in a virtual environment:
python -m pip install cleanup-cli
For the Linux GTK application, install its native prerequisites first, then:
python -m pip install cleanup-gui
See the installation guide for environment setup and Linux package requirements.
Quick start
Preview duplicate removal or WebP conversion:
cleanup-cli deduplicate /path/to/photos
cleanup-cli webp /path/to/photos
Launch the graphical interface:
cleanup-gui
Both tools default to a dry run. Deleting duplicates or replacing originals requires an explicit option; the GUI also asks for confirmation. Review the results and keep backups before applying changes.
Documentation
The documentation covers command options, GUI controls, image matching, resource limits, and path ordering.
Contributing
Bug reports, feature requests, and pull requests are welcome. Use the issue tracker or read CONTRIBUTING.md to get started.
1 maintainer
Metadata
1 maintainer
Release files for cleanup-cli 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| cleanup_cli-0.1.1.tar.gz | 41.5 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cleanup_cli-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 102.0 kB
Release files / cleanup_cli-0.1.1.tar.gz
| Download URL | cleanup_cli-0.1.1.tar.gz |
|---|---|
| Size | 41.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
056094fe01d5dd3637b26ef66794dcd47f44eea44a305514f894bef457f0a253
|
|
BLAKE2b-256 checksum How to use checksums |
57b4ecbb4781abd09a03cdc7c0ea8dc0b23a1dc778a044f9d32ff084ef351a20
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.24 {"installer":{"name":"uv","version":"0.12.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / cleanup_cli-0.1.1-py3-none-any.whl
| Download URL | cleanup_cli-0.1.1-py3-none-any.whl |
|---|---|
| Size | 60.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
aaf9555b7d574543a8745e53083aac14f5b83c056147de4cde36b825ede3af5b
|
|
BLAKE2b-256 checksum How to use checksums |
57a2279c86040ca47244ac2dd8c9213a4322955da1b2d675947f6fb75de68e54
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.24 {"installer":{"name":"uv","version":"0.12.24","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for cleanup-cli 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
