czkawka README

The project's README from github.com/qarmin/czkawka. As one markdown file: README.md.

krokiet_logo

Krokiet ((IPA: [ˈkrɔcɛt]), "croquette" in Polish) new generation GUI frontend, simple, multiplatform, fast and free app to remove unnecessary files from your computer.

czkawka_logo

Czkawka (tch•kav•ka (IPA: [ˈʧ̑kafka]), "hiccup" in Polish) older gtk4 GUI frontend, superseded by Krokiet. Version 12.0 is the last released version - no new binaries will be provided. New users and existing users are encouraged to switch to Krokiet.

cedinia_logo

Cedinia - Android touch friendly GUI frontend for Czkawka Core, built with Slint.

Features

Krokiet

Czkawka

Changelog about each version can be found in CHANGELOG.md.

New releases can be found in Github releases and nightly builds also in Nightly releases

You can read more about the 12.0 release, its new features, and the issues that were fixed in the following articles:

Usage, installation, compilation, requirements, license

Each tool uses different technologies, so you can find instructions for each of them in the appropriate file:

Comparison to other tools

In this comparison remember, that even if app have same features they may work different(e.g. one app may have more options to choose than other).

Krokiet Czkawka Cedinia FSlint DupeGuru Bleachbit
Language Rust Rust Rust Python Python/Obj-C Python
Framework base language Rust C Rust C C/C++/Obj-C/Swift C
Framework Slint GTK 4 Slint PyGTK2 Qt 5 (PyQt)/Cocoa PyGTK3
OS Lin,Mac,Win Lin,Mac,Win Android Lin Lin,Mac,Win Lin,Mac,Win
Duplicate finder ✔ ✔ ✔ ✔ ✔
Empty files ✔ ✔ ✔ ✔
Empty folders ✔ ✔ ✔ ✔
Temporary files ✔ ✔ ✔ ✔ ✔
Big files ✔ ✔ ✔
Similar images ✔ ✔ ✔ ✔
Similar videos(audio) ✔ ✔ ✔
Similar videos(frames) ✔ ✔
Music duplicates(tags) ✔ ✔ ✔ ✔
Music duplicates(content) ✔ ✔ ✔
Invalid symlinks ✔ ✔ ✔
Broken files ✔ ✔ ✔
Invalid names/extensions ✔ ✔ ✔ ✔
Exif cleaner ✔ ✔
Video optimizer ✔
Bad Names ✔ ✔
Names conflict ✔
Installed packages ✔
Bad ID ✔
Non stripped binaries ✔
Redundant whitespace ✔
Overwriting files ✔ ✔
Portable version ✔ ✔ ✔
Multiple languages ✔ ✔ ✔ ✔ ✔ ✔
Cache support ✔ ✔ ✔ ✔
In active development Yes No** Yes*** No No* Yes

* Few small commits added recently and last version released in 2023

** Czkawka GTK 12.0 was the last released version - no new binaries will be provided

*** Cedinia is an android app, video tools are not available due missing ffmpeg in Android

Other apps

There are many similar applications to Czkawka on the Internet, which do some things better and some things worse:

GUI

CLI

Due to limited time, the biggest emphasis is on the GUI version so if you are looking for really good and feature-packed console apps, then take a look at these:

Projects using Czkawka

Czkawka exposes its common functionality through a crate called czkawka_core, which can be reused by other projects.

It is written in Rust and is used by all Czkawka frontends (czkawka_gui, czkawka_cli, krokiet, cedinia).

It is also used by external projects, such as:

Bindings are also available for:

Some projects work as wrappers around czkawka_cli. Without directly depending on czkawka_core, they allow simple scanning and retrieving results in JSON format:

Thanks

Big thanks to Pádraig Brady, creator of fantastic FSlint, because without his work I wouldn't create this tool.

Thanks also to all the people who contributed to the project in every possible way

Also, I really appreciate work of people that create crates on which Czkawka is based and for that I try to report bugs to make it even better.

How to help?

S - Someone
Y - You

Situation 1:

Situation 2:

AI Policy

The vast majority of the code in this project was written by me (qarmin) without using AI. However, as AI tools have improved and can significantly simplify development and reduce boilerplate, I see no reason to forbid their use. I have also added a AGENTS.md file to the repo to make it easier to provide AI tools with context about the project’s style and code structure.

That said, every pull request, whether created with AI or not, must meet proper quality standards. The author must be able to clearly explain what the code does, without relying on AI for that explanation. I manually review every PR and test each change, so the risk of incorrect code slipping through is low. Still, to avoid wasting time, please refrain from submitting AI Slop PRs.

Officially Supported Projects

Only this repository, prebuild-binaries, projects on crates.io and flathub are directly maintained by me.

Czkawka does not have an official website, so do not trust any sites that claim to be the official one.

If you use packages from unofficial sources, make sure they are safe.

License

The entire code in this repository is licensed under the MIT license.

All images and audio files are licensed under the CC BY 4.0 license.

The Czkawka GTK GUI and CLI applications are licensed under the MIT license, while the Krokiet and Cedinia(due Slint license requirements) are licensed under the GPL-3.0-only license.

Donations

If you are using the app, I would appreciate a donation for its further development, which can be done here.

czkawka (qarmin/czkawka)

Searching Database…

34.4K ·GitHub
这是什么?Czkawka 是一款用 Rust 编写的多功能应用,可以在磁盘上查找并清理重复文件、空文件夹、相似的图片/视频/音乐、损坏的文件、临时文件等。
它是一个应用,还是一系列不同的前端?它是一系列前端,共享同一个核心库:Krokiet(基于 Slint 的新图形界面,仍在积极开发)、Czkawka(较旧的 GTK4 图形界面,现已被取代并停止更新)、Cedinia(适合触屏的 Android 图形界面),以及用于自动化的命令行版本。
我该如何安装和运行?可以从 GitHub Releases 下载 Krokiet、Czkawka 图形界面或命令行版本的预编译二进制文件(或每日构建版),也可以从源代码编译;每个前端在仓库中都有单独的文件,说明各自的用法和编译方法。
构建或运行它需要什么特别的东西吗,比如 ffmpeg?核心部分的运行时和构建依赖很少,并且提供便携版。视频优化器等视频工具底层需要 ffmpeg,因此这些工具不包含在 Android(Cedinia)版本中。
Czkawka 的 GTK 图形界面还在继续开发吗?不再开发。Czkawka GTK 的 12.0 版本是最终版本,不会再发布新的二进制文件;用户会被引导使用 Krokiet,它是积极开发中的替代版本。
它实际能在哪些平台上运行?它可以在 Linux、Windows、macOS,甚至 FreeBSD 上运行,支持 x86、ARM 和 RISC-V 架构;还可以通过 Cedinia 前端在 Android 上运行(但视频工具在该平台上不可用)。
它会回传数据或收集任何信息吗?不会,Czkawka 没有联网功能,也不会收集任何用户信息或统计数据。
除了查找重复文件,它还能进行哪些扫描?它还能查找空文件夹和空文件、大文件、临时文件、相似图片、相似视频、按标签或内容判断的重复音乐、无效的符号链接、损坏的文件、扩展名与内容不匹配的文件,还能清除 Exif 元数据或优化视频。
为什么有三个独立的图形界面应用,而不是一个?Krokiet 是正在积极开发的基于 Slint 的新图形界面,旧的基于 GTK4 的 Czkawka 图形界面已冻结在 v12.0 版本、不再更新并被取代,Cedinia 则是针对触屏优化的 Android 前端;这三者都复用同一个 czkawka_core 引擎。
重复扫描同一个文件夹每次都要花同样长的时间吗?不需要,扫描结果会被缓存,因此对未更改文件的第二次及之后的扫描会比第一次快得多。
我能在自己的项目中复用它的扫描引擎吗?可以,czkawka_core Rust crate(库)可以复用,并且已经为一些第三方项目提供支持,比如基于 Tauri 的图形界面前端,以及运行 czkawka_cli 并解析 JSON 输出的 Python 绑定。
Creator
qarmin
Size
12.3 MB
Stars
34.4K
Age
6y
Commits · 90 Days