Installationedit
CubicLauncher is available in the AUR (Arch User Repository). You can install it with your preferred AUR helper or build the official package from the PKGBUILD.
From the AURedit
yay -S cubiclauncherparu -S cubiclauncherIf you don't have yay or paru installed, check their documentation:
You can also view the package at: https://aur.archlinux.org/packages/cubiclauncher
The cubiclauncher package is still published in the AUR, but for now we cannot update it, so it will not receive new CubicLauncher versions. Installing or updating with yay -S cubiclauncher or paru -S cubiclauncher will give you the latest version published in the AUR, but not the newest ones.
To stay up to date, rebuild the official PKGBUILD: edit the pkgver= line, run updpkgsums and then makepkg -si. See Updating CubicLauncher.
Building the PKGBUILDedit
If you prefer to compile manually, you can use the official PKGBUILD. There is no need to clone the full repository or install dependencies manually: the PKGBUILD itself downloads the source code and makepkg handles resolving and installing the necessary dependencies.
Arch Linux is a rolling release distribution, so library and dependency versions change frequently. Binaries generated by GitHub Actions (Ubuntu) may present incompatibilities or fail to run on updated Arch systems. Compiling the program on your own system guarantees compatibility with installed libraries and provides a package tailored to your environment.
mkdir cubiclauncher-build
cd cubiclauncher-build
wget https://raw.githubusercontent.com/CubicLauncherDevs/CubicLauncher/main/dist/arch/PKGBUILD
makepkg -siUpdating CubicLauncheredit
The AUR package is not updated, so moving to a new version requires rebuilding the PKGBUILD. If you already downloaded it, there is no need to download it again from scratch.
Go to the directory where you downloaded the PKGBUILD, edit the file and change the pkgver value to the new version:
cd cubiclauncher-build
nano PKGBUILDLook for the pkgver= line and update it. Then update the checksums automatically with updpkgsums:
updpkgsumsFinally, recompile and install the updated package:
makepkg -siThe updpkgsums command belongs to the pacman-contrib package. If you don't have it installed, you can get it with sudo pacman -S pacman-contrib.
Auto-update does not work on Archedit
CubicLauncher includes a built-in auto-update mechanism that downloads the latest binary from GitHub Releases and replaces the current executable. On Arch Linux this mechanism does not work and cannot be fixed, for the following reasons:
System permissions: When installing via
makepkg -si, the binary is copied to/usr/bin/cubiclauncherwith root permissions (root:root). The normal user does not have write permissions over/usr/bin, so the auto-updater cannot overwrite the file.Binary incompatibility: Even if the auto-updater were run as root, the precompiled binaries from GitHub Actions are linked against Ubuntu libraries, which can cause failures on Arch.
Arch philosophy: On Arch Linux the correct way to update any program is through
pacman. Using external auto-updaters bypasses the package manager, leaving the system in an inconsistent state (pacman will not know the binary was replaced).
Common issuesedit
NVIDIA and Wayland: graphics issuesedit
If CubicLauncher opens a blank window, flickers or crashes when resizing, see Linux graphics issues: NVIDIA and Wayland. It covers WEBKIT_DISABLE_COMPOSITING_MODE=1 cubiclauncher, less restrictive alternatives and checking KMS. Building locally does not guarantee a fix for these rendering issues.
Error downloading dependencies (404)edit
If during installation you see errors similar to the following:
error: failed retrieving file 'gst-plugins-good-*.pkg.tar.zst'
error: failed retrieving file 'gst-plugins-bad-*.pkg.tar.zst'
error: failed to commit transaction (failed to retrieve some files)It is likely that one of the mirrors configured on your system is outdated. Before running makepkg again, update the package database and sync the system:
sudo pacman -SyuIf the problem persists, update your mirror list or try newer mirrors:
sudo pacman -S reflector
sudo reflector --latest 20 --sort rate --save /etc/pacman.d/mirrorlist
sudo pacman -SyyuOnce the system is updated, run again:
makepkg -siThis error is not related to CubicLauncher or the PKGBUILD; it occurs when an Arch Linux mirror has not yet synced the most recent packages.