Linux Installation (.deb / .rpm)

ClipaX has full support on GNOME desktop with X11; GTK and Wayland are partially supported.

Both .deb and .rpm packages are shipped without declared dependencies.
This avoids “not installable” errors or dependency conflicts caused by package name / version differences across distributions.
Please install the required dependencies first (per distro section below), then install ClipaX.

1. Install dependencies by distribution

Before installing ClipaX, run the commands below on your distribution (you only need to do this once per machine).

Ubuntu / Kubuntu 24.04

sudo apt update && sudo apt install -y \
  libwebkit2gtk-4.1-0 \
  libayatana-appindicator3-1 \
  libkeybinder-3.0-0 \
  tesseract-ocr \
  libjsoncpp25 \
  libsqlite3-dev

Fedora 41

sudo dnf install -y \
  libayatana-appindicator-gtk3 \
  keybinder3 \
  tesseract \
  jsoncpp

# Temporary workaround for Fedora 41: align tesseract SONAME
sudo ln -s /lib64/libtesseract.so.5.5 /lib64/libtesseract.so.5.4

2. Install ClipaX

.deb (Ubuntu / Kubuntu)

# Install dependencies first (see above), then install the package
sudo apt install ./clipx_1.1.2_amd64.deb

.rpm (Fedora)

sudo dnf install ./clipx-1.1.2-1.x86_64.rpm

3. Troubleshooting

If the app does not start, run /opt/clipx/clipx from a terminal and check the logs printed there.
If Wayland-related features don’t work properly, try logging in with an X11 session instead:
- Ubuntu / Kubuntu 24.04
  
  Uncomment WaylandEnable=false in /etc/gdm3/custom.conf, then reboot.
- Fedora
  
  Uncomment WaylandEnable=false in /etc/gdm/custom.conf, then reboot.
If you still run into issues, please run the commands below to collect basic system info and either email support@clipax.app or open a GitHub issue at https://github.com/clipax/ClipaX/issues:

# Kernel and architecture
uname -a

# Distribution information
cat /etc/os-release || cat /usr/lib/os-release || true

# Desktop session (Wayland / X11 hint)
echo "DESKTOP_SESSION=$DESKTOP_SESSION"

Linux Installation Guide