Skip to content

Maintainers Packaging

Nathan Price edited this page Apr 27, 2026 · 1 revision

Dependencies

Arch Linux:

sudo pacman -S base-devel cmake libsystemd zlib libpulse libxcb xcb-util-wm qt6-base quazip-qt6 qt6-tools qt6-wayland git

Debian/Ubuntu (24.04+):

sudo apt install build-essential cmake qt6-base-dev libudev-dev zlib1g-dev libpulse-dev libquazip1-qt6-dev qt6-tools-dev qt6-wayland-dev libxcb-screensaver0-dev libxcb-ewmh-dev libxcb1-dev wayland-protocols

Debian/Ubuntu (20.04, 22.04):

sudo apt install build-essential cmake libudev-dev qtbase5-dev zlib1g-dev libpulse-dev libquazip5-dev libqt5x11extras5-dev libxcb-screensaver0-dev libxcb-ewmh-dev libxcb1-dev qttools5-dev git libdbusmenu-qt5-dev

Fedora:

sudo dnf install gcc gcc-c++ make cmake git glibc libxcb-devel make pulseaudio-libs-devel qt6-linguist qt6-qttools-devel qt6-qtbase-devel quazip-qt6-devel qt6-qtwayland-devel systemd-devel xcb-util-devel xcb-util-wm-devel zlib-devel wayland-protocols-devel wayland-devel

If the above returns nothing provides pkgconfig, make sure exclude=xorg-x11* is commented or removed in /etc/dnf/dnf.conf

OpenSUSE:

sudo zypper install gcc gcc-c++ make cmake linux-glibc-devel zlib-devel libqt5-qtbase-devel systemd-devel libpulse-devel quazip-qt5-devel libudev-devel libqt5-linguist-devel git libdbusmenu-qt5-devel libxcb-devel xcb-util-wm-devel libqt5-qtx11extras-devel

Download, compile, and install ckb-next

git clone https://github.com/ckb-next/ckb-next.git && cd ckb-next
./quickinstall

Uninstall ckb-next v0.3.0 or newer

If you built ckb-next from source using quickinstall, and haven't deleted the previous ckb-next folder, you can use

cd ckb-next
sudo cmake --build build --target uninstall

If you used quickinstall, but no longer have the original folder, you can re-run quickinstall using the instructions above, and then after it finishes, simply run

sudo cmake --build build --target uninstall

If you ran cmake manually, you should recall all -DOPTION=VALUE flags (if any) you have used, build the install target and then build the uninstall target. For example:

cmake -H. -Bbuild -DCMAKE_BUILD_TYPE=Release -DSAFE_INSTALL=ON -DSAFE_UNINSTALL=ON -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_INSTALL_LIBEXECDIR=lib
cmake --build build --target all -- -j 4
sudo cmake --build build --target install
sudo cmake --build build --target uninstall

The compilation and installation steps are required because install target generates an install manifest that later allows to determine which files to remove and what is their location.

Uninstall ckb-next 0.2.9 or older, or ckb

You can run the following command to delete any files that may exist from older versions of ckb. It is normal for some errors (no such file or directory) to show up.

sudo rm -r /usr/bin/ckb /usr/lib/systemd/system/ckb-daemon.service /etc/init/ckb-daemon.conf /etc/init.d/ckb-daemon /usr/bin/ckb-daemon /usr/bin/ckb-animations /usr/lib/animations /usr/share/applications/ckb.desktop /usr/local/share/applications/ckb.desktop /usr/share/icons/hicolor/512x512/apps/ckb.png /usr/local/share/icons/hicolor/512x512/apps/ckb.png

Rebuilding AUR packages

Manjaro Add/Remove Software (Pamac)

First, search for the installed package and click on it. In this case it's ckb-next-git.

pamac0

Then, click on the Build button.

pamac1

On the bottom right of the window, click on Apply.

pamac2

Finally, click on Apply again in the new window that popped up.

pamac3

yay

You can run:

yay --rebuildall -S ckb-next-git

A clean build is usually not required.

makepkg

If you haven't deleted the cloned repository directory (ckb-next, ckb-next-git), then you can simply cd into it and run makepkg -f -i to rebuild and reinstall the package.

If the original directory has been deleted, then you can clone and re-run makepkg as usual.

Clone this wiki locally