Arch (AUR) Install — XKG Desktop

Option 1: Install from the local PKGBUILD (works now)

Install the build dependencies

sudo pacman -S --needed base-devel rust nodejs npm git webkit2gtk-4.1 gtk3 librsvg

Download the PKGBUILD

git clone https://github.com/griptoad26/xkg-aur.git
cd xkg-aur

Or download the files directly: PKGBUILD + .SRCINFO into an empty directory.

Build and install

makepkg -si

The -s flag installs missing deps, -i installs the package. First build takes 5–10 minutes (Rust compilation).

Run

xkg-desktop

Press Ctrl+Shift+X anywhere to capture. Settings are at ~/.config/xkg-desktop/.

Option 2: Install from AUR (when published)

Once we push the package to AUR, you'll be able to use any AUR helper:

# yay
yay -S xkg-desktop

# paru
paru -S xkg-desktop

# manual
git clone https://aur.archlinux.org/xkg-desktop.git
cd xkg-desktop
makepkg -si

What gets installed

Path	Purpose
`/usr/bin/xkg-desktop`	The compiled AppImage (executable)
`/usr/share/applications/xkg-desktop.desktop`	Menu entry (shows in app launchers)
`/usr/share/icons/hicolor/*/apps/xkg-desktop.png`	Application icons (32, 128, 256 px)
`/usr/share/licenses/xkg-desktop/LICENSE`	MIT license text
`/usr/share/doc/xkg-desktop/`	README + SYNC docs

Troubleshooting

"webkit2gtk-4.1 not found" — Your distro may use webkit2gtk-4.0 (older) or webkitgtk-6.0 (newer). Edit the depends= line in PKGBUILD to match your version.

"npm ci fails" — Try npm install instead. The PKGBUILD uses npm ci for reproducible builds, which requires a clean package-lock.json.

"permission denied on /usr/bin" — Use makepkg -si (not just makepkg -s); the -i flag runs pacman -U with sudo.

Build takes forever — First Rust compile of Tauri can take 5–10 minutes. Subsequent rebuilds are <30s thanks to incremental compilation.

More help: support form · file an issue

Want to help push it to AUR?

If you have an AUR account and want to be the maintainer of aur.archlinux.org/packages/xkg-desktop, email aur-maintainer@seele.agency. We need:

Your AUR username (we'll add you as a co-maintainer on the package)
Confirmation you've read the AUR submission guidelines
Commitment to push updates within 2 weeks of upstream releases

Install XKG Desktop on Arch Linux