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

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