Void‑Mod

A Void Linux installer for Hyprland/GNOME/Sway and multiple other window manager setups.
Designed for a lightweight but practical desktop setup.
Automates core package installation, GNOME setup, optional WM installs, and basic configuration for a streamlined experience.

Uses xbps-install for native packages, flatpak (Flathub) for apps without Void packages, and runit (sv) for service management.

📦 Features

• Core system install with GNOME desktop support
• Lightweight and fast, perfect for tablets or low-resource devices
• Wayland-first: Hyprland, Sway, i3, and bspwm all supported
• Applies Piercing‑Dots minimal dotfiles
• Post-install health reports for base and Hyprland installers

🚀 Quick Start

git clone https://github.com/PiercingXX/void-mod
cd void-mod
chmod -R u+x scripts/
./void-mod.sh

🛠️ Usage

Run ./void-mod.sh and follow the prompts.
Options include the base install, optional window manager install, persistent TTY rotation, and reboot. The base install flow now applies GNOME polish automatically when a GNOME session is available, installs greetd/tuigreet for the text-first GNOME launcher flow, and prompts inline for optional printer setup.

GDM is optional and disabled by default. The base flow installs greetd and tuigreet; to install and enable GDM instead during the base flow, run:

VOID_INSTALL_GDM=1 ./void-mod.sh

⚙️ Environment Flags

Flag	Default	Description
VOID_INSTALL_GDM	0	Set to 1 to install and enable GDM (display manager). Default: launch GNOME via gnome-wayland or gnome-x11 wrappers.
VOID_FORCE_DEFAULT_MIRROR	1	Set to 0 to skip reconfiguring the xbps repo to repo-default.voidlinux.org before the Hyprland install.
HYPR_SOURCE_FALLBACK	1	Set to 0 to disable the source-build fallback in hyprland-install.sh when binary packages fail.
HYPRSUNSET_PINNED_HYPRUTILS	hyprutils-0.7.1_1	Override the pinned hyprutils version used for the hyprsunset ABI compatibility stack.
HYPRSUNSET_PINNED_HYPRLANG	hyprlang-0.6.3_1	Override the pinned hyprlang version.
HYPRSUNSET_PINNED_PACKAGE	hyprsunset-0.2.0_1	Override the pinned hyprsunset version.

Package availability behaviour

Both step-1.sh and hyprland-install.sh use mirror-tolerant install helpers:

• pkg_installed — checks xbps-query -l for ^ii <pkg>- before installing; already-installed packages are skipped instantly on reruns.
• pkg_available — checks xbps-query -Rs "^<pkg>$" before any install attempt; packages absent from the current repo index are skipped with a [warn] line instead of aborting the script.
• xi_install_safe — wraps both checks; used for all optional/semi-optional packages (waybar, pipewire-pulse, cava, bluetuith, Hyprland Qt extras, etc.).

Required packages that anchor a fallback chain (e.g. hyprland core, mesa, dbus) still use the retrying xi_install helper so mirror-sync failures trigger an index refresh and retry rather than a silent skip.

🔧 Scripts

Script	Purpose
scripts/step-1.sh	Core system packages, GNOME, flatpak, dotfiles
scripts/hyprland-install.sh	Installs Hyprland and Wayland stack
scripts/sway-install.sh	Installs Sway and Wayland stack
scripts/i3-install.sh	Installs i3 and X11 stack
scripts/bspwm-install.sh	Installs bspwm and X11 stack
scripts/rotate-tty-clockwise.sh	Rotates the Linux TTY 90 degrees clockwise and persists it in GRUB
scripts/install-printers.sh	Configures Canon D530 or Omezizy label printer

---

📄 License

MIT © PiercingXX
See the LICENSE file for details.

---

🤝 Contributing

Fork, branch, and PR welcome.

---

📞 Support & Contact

Email: Don’t

Open an issue in the relevant repo instead. If it’s a rant make it entertaining.