Void User Repository

DISCLAIMER

This project is not affiliated with or endorsed by the Void Linux project or its maintainers. It is an unofficial community tool designed to simplify managing and building user-contributed packages using the void-packages build system. Use at your own discretion.

Overview

A collection of template files for building packages on Void Linux. Includes a helper script, vay, which simplifies local package building and installation. If you dont wish to build the packages locally, this repository also provides prebuilt binaries in the releases. Information on how to easily download and install them go to Prebuilt binaries.

Available packages

package version homepage maintainer notes
aquamarine 0.9.5 https://github.com/hyprwm/aquamarine zenobit
btrfs-progs 6.17.1 https://btrfs.wiki.kernel.org/index.php/Main_Page Enno
glaze 6.0.3 https://github.com/stephenberry/glaze zenobit
hyprcursor 0.1.13 https://github.com/hyprwm/hyprcursor zenobit
hyprdynamicmonitors 1.3.5 https://github.com/fiffeek/hyprdynamicmonitors zenobit
hyprgraphics 0.3.0 https://github.com/hyprwm/hyprgraphics zenobit
hypridle 0.1.7 https://github.com/hyprwm/hypridle zenobit
hyprland 0.52.1 https://hyprland.org/ zenobit
hyprland-guiutils 0.1.0 https://github.com/hyprwm/hyprland-guiutils zenobit
hyprland-protocols 0.7.0 https://github.com/hyprwm/hyprland-protocols zenobit
hyprland-qt-support 0.1.0 https://github.com/hyprwm/hyprland-qt-support zenobit
hyprlang 0.6.4 https://github.com/hyprwm/hyprlang zenobit
hyprlock 0.9.2 https://github.com/hyprwm/hyprlock zenobit
hyprpaper 0.7.6 https://github.com/hyprwm/hyprpaper zenobit
hyprpicker 0.4.5 https://github.com/hyprwm/hyprpicker RAR27
hyprpolkitagent 0.1.3 https://github.com/hyprwm/hyprpolkitagent zenobit
hyprsunset 0.3.3 https://github.com/hyprwm/hyprsunset zenobit
hyprsysteminfo 0.1.3 https://github.com/hyprwm/hyprsysteminfo zenobit
hyprtoolkit 0.3.0 https://github.com/hyprwm/hyprtoolkit zenobit
hyprutils 0.10.2 https://github.com/hyprwm/hyprutils zenobit
hyprwayland-scanner 0.4.5 https://github.com/hyprwm/hyprwayland-scanner zenobit
libspng 0.7.4 https://libspng.org/ zenobit
linuxcommandlibrary 3.3.1 http://linuxcommandlibrary.com/ zenobit
ly 1.1.2 https://codeberg.org/fairyglade/ly zenobit i686 x86_64
nebula-gtk 1.1.3 https://github.com/Letdown2491/nebula-gtk Letdown2491
sdbus-cpp 2.1.0 https://github.com/Kistler-Group/sdbus-cpp zenobit
shattered-pixel-dungeon 3.2.5 https://github.com/00-Evan/shattered-pixel-dungeon Mihail
tomlplusplus 3.4.0 https://marzer.github.io/tomlplusplus/ zenobit
vbm 1.0.1 https://codeberg.org/oSoWoSo/vbm zenobit
xdg-desktop-portal-hyprland 1.3.11 https://github.com/hyprwm/xdg-desktop-portal-hyprland zenobit
zen-browser 1.17.4b https://www.zen-browser.app/ Encoded14 x86_64 aarch64
zig 0.14.1 https://ziglang.org Orphaned x86_64* aarch64*

The vay script

vay works similarly to AUR helpers on Arch Linux. Automatically performs the actions needed to build the packages locally on your system. If you prefer to do this manually go to Manually building. Note: this script not only works for the extra template files provided in this repository but also for packages not distrubted in the Voidlinux mirrors such as nonfree packages (discord, spotify, etc.)

Installation

  1. Start by cloning this repository.
git clone https://github.com/oSoWoSo/void-user-repository
  1. Change into the cloned directory:
cd void-user-repository
  1. Create ~/.local/bin if it doesn’t already exist:
mkdir -p ~/.local/bin
  1. Symlink the helper script:
ln -sf "$(realpath vay.sh)" "$HOME/.local/bin/vay"
  1. Run the helper by typing vay followed by one or more package names:
vay <package1> <package2> ...

Prebuilt binaries

Currently prebuilt binary packages are provided for the following architectures:

  1. Create an entry in /etc/xbps.d/ and add this repository. This can be done with the following commands:
echo repository=https://github.com/oSoWoSo/VUR-x86_64/raw/refs/heads/bin | sudo tee /etc/xbps.d/00-VUR.conf
echo repository=https://github.com/oSoWoSo/VUR-x86_64-musl/raw/refs/heads/bin | sudo tee /etc/xbps.d/00-VUR.conf
echo repository=https://github.com/oSoWoSo/VUR-aarch64/raw/refs/heads/bin | sudo tee /etc/xbps.d/00-VUR.conf
echo repository=https://github.com/oSoWoSo/VUR-aarch64-musl/raw/refs/heads/bin | sudo tee /etc/xbps.d/00-VUR.conf
  1. Refresh your repositories and accept the fingerprint:
sudo xbps-install -S
  1. You are now able to search through all of the packages in this repository, and install them as usual:
xbps-query -Rs hypr
sudo xbps-install -S hyprland

Manually building

  1. Clone both this repository as well as void-packages:
git clone https://github.com/oSoWoSo/void-user-repository.git
git clone https://github.com/void-linux/void-packages.git
  1. Copy the templates files from this repository into void-packages:
cp -r void-user-repository/srcpkgs/* void-packages/srcpkgs/

  1. Edit shlibs by removing the lines found in shlibs_remove and appending the lines from shlibs_append.

  2. Bootstrap the build system:

cd void-packages
./xbps-src binary-bootstrap
  1. Build the packages you want:
./xbps-src pkg <package1> <package2> ...
  1. Install the built packages:
sudo xbps-install --repository /hostdir/binpkgs/ <package1> <package2> ...

Running 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. You may also have to add the user to the _seatd group. If you use an Nvidia GPU refer to the Hyprland Wiki, but keep in mind that Hyprland does not officially support Nvidia.

Contributing

Contributions are greatly appreciated. Overall, this repository adheres to the same rules and guidelines as the official void-packages repository. The main difference is that here, you’re welcome to add template files for Chromium or Firefox forks if they provide additional value beyond changing certain settings or configuration files.

Credits

Makrennel: hyprland-void: Hyprland template files

Encoded14: void-user-repository: Better workflow file and some templates

grvn: void-packages: various template files