Blackhole-vl

Note

This project is not affiliated with or endorsed by the Void Linux project or its maintainers.

Use at your own discretion.

Overview

A collection of template files for building packages on Void Linux with xbps-src.

This repository provides:

• stable templates with prebuilt binaries (main branch)
• fully working templates without binaries (manual branch)

---

Branches

Important

The manual branch includes a larger set of packages compared to main.

Some packages are only available there due to size or build constraints. If something is missing in main, you will likely find it in manual. This repository is split into branches with different guarantees:

main

• Stable and tested templates
• Prebuilt binary packages are provided
• Recommended for end users

manual

• Templates are expected to build successfully
• No prebuilt binaries are provided
• Intended for local/manual builds only
• This branch exists due to GitHub size and storage limitations

package-specific branches

• One branch per package or feature under development
• Used for testing, refactoring, or initial bring-up
• May be incomplete or broken
• Changes are merged into manual or main only after validation

---

Installation

Currently packages are tested on / crosscompiled for the following architectures:

• x86_64
• x86_64-musl
• aarch64
• aarch64-musl

Manually building

Recommended for the manual branch

1. Clone both this repository and void-packages:

   git clone https://github.com/Event-Horizon-VL/blackhole-vl.git
   git clone https://github.com/void-linux/void-packages.git
   

2. (Optional) Switch to a specific branch:

   cd blackhole-vl
   git checkout manual
   

3. Copy the template files into void-packages:

   cp -r blackhole-vl/srcpkgs/* void-packages/srcpkgs/
   

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

   cd void-packages
   nvim common/shlibs
   

5. Bootstrap the build system:

   ./xbps-src binary-bootstrap
   

6. Build the desired packages:

   ./xbps-src pkg <package1> <package2> ...
   

7. Install the built packages:

   sudo xbps-install --repository /hostdir/binpkgs/ <package1> <package2> ...
   

📦 Prebuilt binaries

Available only for the main branch

1. Create an entry in /etc/xbps.d/ and add this repository
   (replace the architecture as needed):

   echo repository=https://raw.githubusercontent.com/Event-Horizon-VL/blackhole-vl/repository-x86_64 | sudo tee /etc/xbps.d/20-repository-extra.conf
   

2. Refresh repositories and accept the fingerprint:

   sudo xbps-install -S
   

3. Search and install packages as usual:

   xbps-query -Rs hypr
   sudo xbps-install -S hyprland
   

---

Contributing

Contributions are highly appreciated.

Contribution workflow:

• Do not target manual directly unless the resulting .xbps package is smaller than 100 MB and requires less than 8 GB of RAM to build.
• In all other cases, the pull request must target manual.

This repository follows the same general rules and guidelines as void-packages CONTRIBUTING.md.

---

Credits

• Makrennel: hyprland-void: Hyprland template files

Special thanks

• Encoded14

💖 Support My Work

Boosty • BuyMeaCoffee