Cargando

Cargando...

Skip to content
CubicLauncherDocs

Installation on Arch Linux

CubicLauncher is available in the AUR (Arch User Repository). You can install it with your preferred AUR helper.

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

bash
yay -S cubiclauncher
bash
paru -S cubiclauncher

If 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 AUR package no longer receives updates

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.

Local compilation is optional.

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.

bash
mkdir cubiclauncher-build
cd cubiclauncher-build

wget https://raw.githubusercontent.com/CubicLauncherDevs/CubicLauncher/main/dist/arch/PKGBUILD
makepkg -si

Updating 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:

bash
cd cubiclauncher-build
nano PKGBUILD

Look for the pkgver= line and update it. Then update the checksums automatically with updpkgsums:

bash
updpkgsums

Finally, recompile and install the updated package:

bash
makepkg -si
NOTE

The 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:

  1. System permissions: When installing via makepkg -si, the binary is copied to /usr/bin/cubiclauncher with root permissions (root:root). The normal user does not have write permissions over /usr/bin, so the auto-updater cannot overwrite the file.

  2. 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.

  3. 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:

text
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:

bash
sudo pacman -Syu

If the problem persists, update your mirror list or try newer mirrors:

bash
sudo pacman -S reflector
sudo reflector --latest 20 --sort rate --save /etc/pacman.d/mirrorlist
sudo pacman -Syyu

Once the system is updated, run again:

bash
makepkg -si
WARNING

This error is not related to CubicLauncher or the PKGBUILD; it occurs when an Arch Linux mirror has not yet synced the most recent packages.