5
0
Fork
You've already forked void-driver-app
0
A modern GTK4 setup tool for Void Linux Graphics drivers, printers, and scanners—all with a single click.
  • Python 95.1%
  • Shell 4.9%
2026年05月31日 15:08:22 +02:00
driver.py Dateien nach „/" hochladen 2026年05月31日 15:08:22 +02:00
install.sh Dateien nach „/" hochladen 2026年05月31日 15:08:22 +02:00
README.md Dateien nach „/" hochladen 2026年05月31日 15:08:22 +02:00

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

Screenshots

Coming soon.

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
sudo bash 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

Package Purpose
python3-gobject GTK Python bindings
gtk4 GUI toolkit
libadwaita GNOME HIG widgets
pciutils GPU/PCI detection
python3-cups Printer management
cups Print system
avahi + nss-mdns Network device discovery
dbus Inter-process communication

Usage

The application is organized into five tabs:

Tab Description
Graphics Card Detect GPU, view active driver, install/update drivers
System Hardware Configure network, Bluetooth, audio, and system services
Printer System Discover and install printers and scanners
Printer Drivers Install manufacturer-specific driver packages
Software Install additional system utilities and applications

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

Contributing

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