Hyprland 0.52.1 requires hyprgraphics >= 0.1.6, updated from v0.1.5.
Changes:
- install-scripts/hyprgraphics.sh: Updated tag from v0.1.5 to v0.1.6
- hypr-tags.env: Updated HYPRGRAPHICS_TAG to v0.1.6
- update-hyprland.sh: Updated default HYPRGRAPHICS_TAG to v0.1.6
- refresh-hypr-tags.sh: Updated HYPRGRAPHICS_TAG to v0.1.6
- Debian-Hyprland-Install-Upgrade.md: Updated documentation
- Debian-Hyprland-Install-Upgrade.es.md: Updated Spanish documentation
This resolves the CMake error:
Package 'hyprgraphics' has version '0.1.5', required version is '>= 0.1.6'
BREAKING CHANGE: hyprland-qtutils package renamed to hyprland-guiutils
Changes:
- Updated Hyprland version from v0.51.1 to v0.52.1
- Renamed hyprland-qtutils.sh to hyprland-guiutils.sh to match upstream repository rename
- Updated all environment variable references from HYPRLAND_QTUTILS_TAG to HYPRLAND_GUIUTILS_TAG
- Updated repository URL from hyprwm/hyprland-qtutils to hyprwm/hyprland-guiutils
Modified files:
- install-scripts/hyprland.sh: Updated Hyprland tag to v0.52.1
- install-scripts/hyprland-qtutils.sh: Renamed to hyprland-guiutils.sh
* Updated all internal references and log file names
* Changed repository clone URL to hyprland-guiutils
* Renamed array variable from qtutils to guiutils
- hypr-tags.env: Updated HYPRLAND_TAG to v0.52.1 and renamed HYPRLAND_QTUTILS_TAG to HYPRLAND_GUIUTILS_TAG
- install.sh: Updated export statement to use HYPRLAND_GUIUTILS_TAG
- refresh-hypr-tags.sh: Updated tag name and repository mapping
- update-hyprland.sh:
* Updated component list to reference hyprland-guiutils
* Updated default tags to use HYPRLAND_GUIUTILS_TAG
* Updated export statements in all relevant functions
* Updated repository mapping array
* Updated command-line argument parsing for guiutils
- dry-run-build.sh: Updated component list and example usage
- Debian-Hyprland-Install-Upgrade.md: Updated documentation with new tag name and skip examples
- Debian-Hyprland-Install-Upgrade.es.md: Updated Spanish documentation with new tag name
- WARP.md: Updated module list documentation
Rationale:
As of Hyprland 0.52.1, the upstream hyprland-qtutils repository has been renamed to
hyprland-guiutils. This update ensures compatibility with the latest Hyprland release
and aligns the build scripts with the current upstream repository structure.
References:
- Upstream repository: https://github.com/hyprwm/hyprland-guiutils
Introduce focused Hyprland stack upgrade tooling and improve install
ordering for 0.51.x, with centralized version management and detailed
documentation for upgrading from 0.49/0.50.x to 0.51.1.
New scripts and modules
- update-hyprland.sh: Manage the Hyprland stack with:
- --install / --dry-run build modes
- --only and --skip for selective components
- --with-deps to (re)install build deps
- --set {KEY=TAG} and --restore tag backup support
- --fetch-latest to pull latest GitHub release tags
- --via-helper to delegate summary-only dry-runs
- dry-run-build.sh: Compile-only helper with summary output
- install-scripts/wayland-protocols-src.sh: Build wayland-protocols from
source (>= 1.45) to satisfy Hyprland 0.51.x requirements
Core features
- Centralized tag management via hypr-tags.env; tags exported to all
modules. Environment overrides remain first priority.
- Automatic dependency ordering for Hyprland 0.51.x:
wayland-protocols-src → hyprland-protocols → hyprutils → hyprlang →
aquamarine → hyprland
- Optional auto-fetch of latest tags on install runs that include
hyprland (can be disabled via --no-fetch)
- Selective updates for targeted components and skip lists
- Dry-run mode to validate builds without installing
Installer integration
- install.sh reads hypr-tags.env and optionally refreshes tags.
- Ensures wayland-protocols-src is built before Hyprland.
- Maintains robust sequencing for the Hyprland stack.
Docs
- Debian-Hyprland-Install-Upgrade.md and .es.md:
- Add explicit section: Upgrade 0.49/0.50.x → 0.51.1
- Recommend: `./update-hyprland.sh --install --only hyprland`
- Provide optional `--with-deps` and `--dry-run` flows
- Add quick link anchor under Upgrade Workflows
- Clarify that full install via install.sh is not required for this
upgrade unless optional modules need refresh or recovering from a
partial/failed setup
Usage highlights
- Pin and upgrade to 0.51.1:
./update-hyprland.sh --set HYPRLAND=v0.51.1
./update-hyprland.sh --install --only hyprland
- Optional:
./update-hyprland.sh --with-deps --install --only hyprland
./update-hyprland.sh --dry-run --only hyprland
Notes
- Target OS remains Debian Trixie/SID; run as sudo-capable user (not
root); ensure deb-src entries are enabled.
On branch hl-051
Your branch is up to date with 'origin/hl-051'.
Changes to be committed:
modified: install.sh
modified: refresh-hypr-tags.sh
modified: update-hyprland.sh
On branch hl-051
Your branch is up to date with 'origin/hl-051'.
Changes to be committed:
modified: install.sh
new file: refresh-hypr-tags.sh
modified: update-hyprland.sh
On branch hl-051
Your branch is up to date with 'origin/hl-051'.
Changes to be committed:
modified: install-scripts/aquamarine.sh
modified: install-scripts/hyprland.sh
modified: update-hyprland.sh
On branch hl-051
Your branch is up to date with 'origin/hl-051'.
Changes to be committed:
modified: auto-install.sh
modified: dry-run-build.sh
modified: install-scripts/aquamarine.sh
modified: install-scripts/hyprgraphics.sh
modified: install-scripts/hyprland-protocols.sh
modified: install-scripts/hyprland-qt-support.sh
modified: install-scripts/hyprland-qtutils.sh
modified: install-scripts/hyprland.sh
modified: install-scripts/hyprlang.sh
modified: install-scripts/hyprutils.sh
modified: install-scripts/hyprwayland-scanner.sh
modified: install.sh
modified: preset.sh
modified: update-hyprland.sh
On branch hl-051
Your branch is up to date with 'origin/hl-051'.
Changes to be committed:
modified: hypr-tags.env
modified: install-scripts/wayland-protocols-src.sh
modified: update-hyprland.sh
On branch hl-051
Your branch is up to date with 'origin/hl-051'.
Changes to be committed:
modified: dry-run-build.sh
modified: hypr-tags.env
new file: install-scripts/wayland-protocols-src.sh
modified: update-hyprland.sh
On branch hl-051
Your branch is up to date with 'origin/hl-051'.
Changes to be committed:
modified: dry-run-build.sh
modified: hypr-tags.env
modified: update-hyprland.sh
On branch hl-051
Your branch is up to date with 'origin/hl-051'.
Changes to be committed:
new file: hypr-tags.env
modified: install-scripts/aquamarine.sh
modified: install-scripts/hyprgraphics.sh
modified: install-scripts/hyprland-protocols.sh
modified: install-scripts/hyprland-qt-support.sh
modified: install-scripts/hyprland-qtutils.sh
modified: install-scripts/hyprland.sh
modified: install-scripts/hyprlang.sh
modified: install-scripts/hyprutils.sh
modified: install-scripts/hyprwayland-scanner.sh
new file: update-hyprland.sh
