Void Hardware Assistant

A modern GTK4 hardware management tool for Void Linux — manage GPU drivers, printers, scanners, and system software from a clean graphical interface.

Overview

Void Hardware Assistant is a native GTK4/Adwaita application that simplifies hardware configuration on Void Linux. Instead of manually hunting down XBPS package names or running lspci from the terminal, the app detects your hardware and guides you to the right drivers and settings — all from a polished, responsive GUI.

Features

🖥️ GPU Management

• Automatically detects installed GPUs via lspci (NVIDIA, AMD, Intel)
• Identifies the currently active kernel driver
• Suggests the correct driver packages based on your hardware, including legacy NVIDIA support (390xx, 470xx)
• Optional toggles for Vulkan, 32-bit libraries, and firmware packages
• Allows manual command editing before installation

📡 System Hardware

• One-click setup for Wi-Fi & NetworkManager, Bluetooth (BlueZ), and Audio (PipeWire)
• Repository, firewall (UFW), and service/permissions configuration
• Manufacturer driver support and device discovery

🖨️ Printer & Scanner Management

• Network and USB printer discovery via CUPS
• Driverless printer installation using IPP Everywhere (lpadmin)
• Scanner detection via SANE (scanimage)
• Curated printer driver packages for major manufacturers

📦 Software Tab

• Install commonly needed packages for documents, scanning, system monitoring, and audio firmware — all from a single view

🔄 In-App Updates

• Downloads the latest version directly from Codeberg
• Validates the downloaded script before applying it
• Elevates with pkexec — no terminal required

🎨 UI & Preferences

• Light, Dark, and System theme modes
• 4 languages supported: German, English, French, Spanish (auto-detected from system locale)
• Settings are saved persistently to ~/.config/void-hardwaremanager/settings.ini

Requirements

• Void Linux (musl or glibc)
• Python 3
• GTK4 + Libadwaita
• pciutils (lspci)

All dependencies are installed automatically by the installer script.

Installation

Clone or download the repository, then run the installer as root:

git clone https://codeberg.org/pinguin-void/Void-Driver-App
cd Void-Driver-App
chmod +x install.sh
sudo ./install.sh

The installer will:

1. Install all required dependencies via xbps-install
2. Copy the application to /usr/local/bin/void-hardwaremanager
3. Create a .desktop launcher entry for your application menu

After installation, launch the app from your application menu or run:

void-hardwaremanager

Dependencies

Usage

The application is organized into five tabs:

Use the header bar buttons to rescan hardware, switch themes, change the language, or open the About dialog.

Updating

You can update the application directly from within the Software tab using the Install Update button. The app will fetch the latest version from Codeberg, verify the script, and install it with elevated privileges.

Project

• Source: codeberg.org/pinguin-void/Void-Driver-App
• Designed by: Pinguin-TV
• License: see repository

Contributing

Contributions, bug reports, and feature requests are welcome on Codeberg.