This repository contains template files for building Hyprland using xbps-src.
- You may want to start by making a directory where you can keep the relevant repositories
mkdir ~/repos
cd ~/repos
- Set up a void-packages clone for building templates files
git clone https://github.com/void-linux/void-packages
cd void-packages
./xbps-src binary-bootstrap
cd ..
- Clone this repository:
git clone https://github.com/Makrennel/hyprland-void.git
cd hyprland-void
- Append shared libraries to the end of your void-packages shared libraries
cat common/shlibs >> ../void-packages/common/shlibs
- Copy srcpkgs to your void-packages srcpkgs directory
cp -r srcpkgs/* ../void-packages/srcpkgs
- Build and install packages
cd ../void-packages
./xbps-src pkg hyprland
sudo xbps-install -R hostdir/binpkgs hyprland
In order to run Hyprland you will need to install some additional packages which will depend on your setup, for example a session and seat manager and graphics drivers.
The hyprland-nvidia package is now just a dummy package with the normal hyprland package as a dependency, as patches were made redundant in version 0.33.0. However, Nvidia support is still unofficial; refer to the manual, and bear this in mind.
If Hyprland updates and this repository changes, you may want to perform a hard reset and clean of your cloned void-packages repository to ensure changes are correctly applied when repeating steps 4 and 5 after a git pull on both void-packages and hyprland-void. (BEWARE: This will also reset any changes you have made to any other packages locally - you will have to figure it out yourself in this case)
sudo xbps-install -Su # Update system normally first to avoid building every package needing update from source
cd ~/repos/void-packages
git clean -fd
git reset --hard
git pull
cd ../hyprland-void
git pull
cat common/shlibs >> ../void-packages/common/shlibs # Repeat steps 2 and 3
cp -r srcpkgs/* ../void-packages/srcpkgs
cd ../void-packages
./xbps-src update-sys
Sometimes old stuff isn't particularly easy to clean up between versions, and it may be necessary to remove your old void-packages clone and just reclone it. If you run into problems when updating, please try this first before reporting the issue.
cd ~/repos
# remove old clone of void-packages
rm -r void-packages
# make a fresh clone of void-packages
git clone https://github.com/void-linux/void-packages
cd void-packages
./xbps-src binary-bootstrap
# update hyprland-void and copy hyprland-void stuff again
cd ../hyprland-void
git pull
cat common/shlibs >> ../void-packages/common/shlibs
cp -r srcpkgs/* ../void-packages/srcpkgs
# update
cd ../void-packages
sudo xbps-install -Su
./xbps-src update-sys
This repository also includes other templates which may be of interest for:
- hyprpaper
- xdg-desktop-portal-hyprland
You may also be interested in EWW, for which a template is available in a separate repository as it is not specific to Hyprland.