czk
A CLI wrapper around czkawka_cli focused on usability and easier analysis of duplicate images and videos.
Features
- Dry-run and live deletion modes with colorized, grouped terminal output
- CSV and JSON reports per run
- Interactive SQL analysis via DuckDB
- Self-contained HTML visual report with inline image/video previews, search, and pagination
Requirements
- macOS or Linux
czkawka_cli— duplicate detection engineduckdbCLI — required forczk analyze- Python +
uv
Installation
# From PyPI (recommended)
uv tool install czk-tool
# or with pip
pip install czk-tool
# From source
uv tool install --editable .
Usage
czk test <directory> # Dry run — scan for duplicates, no deletion
czk execute <directory> # Delete duplicates (AEB strategy)
czk analyze <directory> # Interactive DuckDB SQL session over scan results
czk viz <directory> # Generate a self-contained HTML visual report
czk check is an alias for czk test; czk analyse is an alias for czk analyze.
Options
| Flag | Description |
|---|---|
--media {both,images,videos} |
Media type to scan (default: both) |
-s, --similarity-preset |
Image similarity preset: Original, VeryHigh, High, Medium, Small, VerySmall, Minimal (default: High) |
-c, --hash-size {8,16,32,64} |
Perceptual hash size for images (default: 32) |
-g, --hash-alg |
Hash algorithm for images: Mean, Gradient, Blockhash, VertGradient, DoubleGradient, Median (default: Gradient) |
-z, --image-filter |
Resize filter for images: Lanczos3, Nearest, Triangle, Faussian, Catmullrom (default: Nearest) |
-t, --tolerance 0..20 |
Similarity tolerance for videos (default: 10) |
--top N |
Limit duplicate groups in previews (default: 50) |
--all |
Show all duplicate groups, overrides --top |
--out-dir <path> |
Output directory (default: <system-temp>/czk-reports) |
--no-color |
Disable colored output |
Output
Each run writes timestamped artifacts to the output directory:
<base>-<media>-<YYYYMMDD-HHMMSS>.json<base>-<media>-<YYYYMMDD-HHMMSS>.csv<base>-viz-<YYYYMMDD-HHMMSS>.html(czk vizonly)
CSV columns: index, file_to_keep, files_to_remove, count
Disclaimer
Parts of this project were assisted by AI tooling. Review all commands carefully before running, especially deletion workflows. This software is provided "as is" without warranties of any kind. The authors are not liable for any data loss or other damages resulting from use.
1 maintainer
Release files for czk-tool 1.0.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| czk_tool-1.0.10.tar.gz | 36.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| czk_tool-1.0.10-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 67.3 kB
Release files / czk_tool-1.0.10.tar.gz
| Download URL | czk_tool-1.0.10.tar.gz |
|---|---|
| Size | 36.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
24755ac0dc9503356df710cd75b3f9f0cf4967899dde5d5a46fe990d01bf7ed5
|
|
BLAKE2b-256 checksum How to use checksums |
420af929f312cc99c3acc2f7211417933776db450d37f9df513c824624507f54
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","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 / czk_tool-1.0.10-py3-none-any.whl
| Download URL | czk_tool-1.0.10-py3-none-any.whl |
|---|---|
| Size | 30.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8a7c9cb0cf9a9babcba5fdb1a1aa45164c6a4da5cd6c3dee4daffbcaae7d0468
|
|
BLAKE2b-256 checksum How to use checksums |
f9f65f15c458d507f791c7d782a57c5e904cb66017d3296918bf27feeaad330c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","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}
|
