breezy-desktop/PKGBUILD.kwin.README.md

2.9 KiB

Breezy Desktop KWin Plugin - AUR PKGBUILD

This directory contains the PKGBUILD file for creating an Arch Linux AUR package for the Breezy Desktop KWin plugin.

File

  • PKGBUILD.kwin - AUR PKGBUILD for breezy-desktop-kwin-git

About

The breezy-desktop-kwin-git package provides the KWin plugin for Breezy Desktop, which enables virtual desktop environments for gaming and productivity on KDE Plasma 6 using supported XR glasses.

Installation via AUR

Once this PKGBUILD is published to AUR, Arch Linux users can install Breezy Desktop for KWin with:

yay -S breezy-desktop-kwin-git

or using other AUR helpers like paru.

After installation:

  1. Log out and back in
  2. Enable "Breezy Desktop" from the Desktop Effects in System Settings
  3. Launch the Breezy Desktop application to configure settings

Important: If you have previously installed Breezy Desktop using the setup script, you must uninstall it first using ~/.local/bin/breezy_kwin_uninstall before installing via AUR.

Dependencies

The package requires:

  • KDE Plasma 6 (KWin) with Wayland support
  • Qt6 (base and declarative modules)
  • KDE Frameworks 6 (kconfig, kconfigwidgets, kcoreaddons, kglobalaccel, ki18n, kcmutils, kwindowsystem, kxmlgui)
  • Python 3
  • libepoxy and libxcb
  • xr-driver-git >= 2.0.0 (XR driver backend)

Manual Build

To build the package manually without publishing to AUR:

  1. Copy PKGBUILD.kwin to a clean build directory
  2. Rename it to PKGBUILD
  3. Run makepkg -si to build and install

Publishing to AUR

To publish or update this package on AUR:

  1. Create or clone the AUR repository for breezy-desktop-kwin-git
  2. Copy the contents of PKGBUILD.kwin to PKGBUILD in the AUR repo
  3. Update .SRCINFO by running: makepkg --printsrcinfo > .SRCINFO
  4. Commit and push to AUR

Notes

  • This package builds from the latest git source
  • The version is automatically derived from the VERSION file in the repository
  • Git submodules (sombrero, PyXRLinuxDriverIPC) are automatically initialized during build
  • The package installs to system directories (/usr) following Arch Linux packaging standards
  • Users must be on Wayland to use virtual display features
  • For X11 users, only physical display features will work
  • The prepare() step checks for existing script-based installations and will exit if found

Structure

This PKGBUILD follows the same structure as the GNOME variant:

  • Uses _pkgbase variable for consistency
  • Initializes git submodules in build() step
  • Checks for existing installations in prepare() step
  • Uses md5sums for checksums
  • License format matches GNOME package (GPL-3.0)

See Also