2021-05-01 21:14:02 +12:00
# Installation
## Requirements
### Linux
If you use Snap, Flatpak or Appimage, you may skip this section.
2021-05-04 01:44:42 +12:00
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).
2021-05-01 21:14:02 +12:00
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
2021-05-23 21:42:28 +12:00
Currently, you need to manually install `GTK 3` libraries and the Adwaita theme, because they are dynamically loaded from the OS (*we need
2021-05-17 04:44:36 +12:00
help in using static linking*). One very straight-forward way to do this is by using [Homebrew ](https://brew.sh/ ). Installation in the terminal:
2021-05-01 21:14:02 +12:00
```shell
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2021-05-23 21:42:28 +12:00
brew install gtk+3 adwaita-icon-theme
2021-05-01 21:14:02 +12:00
```
After that, go to the location where you downloaded Czkawka and add the `executable` permission to this file.
```shell
chmod +x mac_czkawka_gui
```
At the end execute it:
```shell
./mac_czkawka_gui
```
### Windows
2021-07-03 04:39:44 +12:00
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`
2021-05-01 21:14:02 +12:00
runtime from [**here** ](https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases ).
## Installation
### Precompiled binaries
Ready-to-go executables for Linux, Windows and macOS are available [**here** ](https://github.com/qarmin/czkawka/releases/ ).
2021-07-03 04:39:44 +12:00
If the app does not run when clicking the launcher, run it through a terminal.
2021-05-01 21:14:02 +12:00
You don't need to have any additional libraries for CLI Czkawka.
### Nightly Builds
Artifacts from each commit can be downloaded [**here** ](https://github.com/qarmin/czkawka/actions )
### Appimage
Appimage files are available in release page - [**GitHub releases** ](https://github.com/qarmin/czkawka/releases/ )
2021-07-03 04:39:44 +12:00
This version is bundled with its own theme.
2021-05-01 21:14:02 +12:00
There is also a small problem with not being able to open 2 images at once.
### Cargo
2021-07-03 04:39:44 +12:00
The easiest method to install Czkawka is using the `cargo` command. To compile it, you need to get all the
2021-05-01 21:14:02 +12:00
requirements from the [compilation section ](Compilation.md ).
```
cargo install czkawka_gui
cargo install czkawka_cli
```
You can update the package with the same command.
### Snap
```
sudo snap install czkawka
```
2021-07-03 04:39:44 +12:00
By default, Snap can only access the files in your home directory. You have to allow czkawka access to all the drives:
2021-05-01 21:14:02 +12:00
```
sudo snap connect czkawka:removable-media
```
The Snap store entry can be found [**here** ](https://snapcraft.io/czkawka ).
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** ](https://flathub.org/apps/details/com.github.qarmin.czkawka )
#
#
**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)
2021-05-04 01:44:42 +12:00
Czkawka docker image is available [**here** ](https://github.com/jlesage/docker-czkawka )