1
0
Fork 0
mirror of synced 2024-04-28 17:42:26 +12:00
czkawka/instructions/Installation.md

3.7 KiB

Installation

Requirements

Linux

If you use Snap, Flatpak or Appimage, you may skip this section.

For Czkawka GUI you are required to have at least GTK 3.22 and also Alsa installed (for finding broken music files, but it is disabled by default).
It should be installed by default on all the most popular distros.

Ubuntu/Debian

sudo apt install libgtk-3-dev

Fedora/CentOS

sudo yum install gtk3-devel glib2-devel

Void Linux (CLI only)

sudo xbps-install gcc pkg-config alsa-lib-devel

macOS

Currently, you need to manually install GTK 3 libraries and the Adwaita theme, because they are dynamically loaded from the OS (we need help in using static linking). One very straight-forward way to do this is by using Homebrew. Installation in the terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install gtk+3 adwaita-icon-theme

After that, go to the location where you downloaded Czkawka and add the executable permission to this file.

chmod +x mac_czkawka_gui

At the end execute it:

./mac_czkawka_gui

Windows

By default, all needed libraries are bundled with the app, inside windows_czkawka_gui.zip, but if you compile the app or just move czkawka_gui.exe, then you will need to install the GTK 3 runtime from here.

Installation

Precompiled binaries

Ready-to-go executables for Linux, Windows and macOS are available here.
If the app does not run when clicking the launcher, run it through a terminal.
You don't need to have any additional libraries for CLI Czkawka.

Nightly Builds

Artifacts from each commit can be downloaded here

Appimage

Appimage files are available in release page - GitHub releases
This version is bundled with its own theme.
There is also a small problem with not being able to open 2 images at once.

Cargo

The easiest method to install Czkawka is using the cargo command. To compile it, you need to get all the requirements from the compilation section.

cargo install czkawka_gui
cargo install czkawka_cli

You can update the package with the same command.

Snap

sudo snap install czkawka

By default, Snap can only access the files in your home directory. You have to allow czkawka access to all the drives:

sudo snap connect czkawka:removable-media

The Snap store entry can be found here.

Fresh builds are available in edge branch, but they may be a little unstable, although that happens very rarely because I don't push untested code.

Flatpak

flatpak install flathub com.github.qarmin.czkawka

Flathub page with Czkawka can be found here

Unofficial packages, which may not always provide the latest version of Czkawka.

PPA - Debian/Ubuntu (unofficial)

sudo add-apt-repository ppa:xtradeb/apps
sudo apt-get update
sudo apt-get install czkawka

AUR - Arch Linux Package (unofficial)

Czkawka is also available in Arch Linux's AUR from which it can be easily installed.

yay -Syu czkawka-git

or

yay -Syu czkawka-gui-bin
yay -Syu czkawka-cli-bin

Package info's - https://aur.archlinux.org/packages/?O=0&SeB=nd&K=czkawka&outdated=&SB=n&SO=a&PP=50&do_Search=Go

Docker image (unofficial)

Czkawka docker image is available here