Linuwu-DAMX Unified Installer
This repository provides a high-performance, automated deployment suite for the Linuwu-Sense kernel driver and the DAMX (Div Acer Manager Max) GUI suite. It is engineered specifically for Acer Nitro, Predator, Helios, and Triton series laptops running Arch Linux or CachyOS.
Core Features
- Automated DKMS Integration: The Linuwu-Sense driver is registered via Dynamic Kernel Module Support (DKMS), ensuring the module persists and automatically rebuilds during kernel updates without manual user intervention.
- CachyOS Optimization: Logic includes automatic detection of the CachyOS kernel to resolve and install the appropriate LLVM/Clang headers instead of generic linux-headers.
- System-Native Dependency Management: Installation scrip…
Linuwu-DAMX Unified Installer
This repository provides a high-performance, automated deployment suite for the Linuwu-Sense kernel driver and the DAMX (Div Acer Manager Max) GUI suite. It is engineered specifically for Acer Nitro, Predator, Helios, and Triton series laptops running Arch Linux or CachyOS.
Core Features
- Automated DKMS Integration: The Linuwu-Sense driver is registered via Dynamic Kernel Module Support (DKMS), ensuring the module persists and automatically rebuilds during kernel updates without manual user intervention.
- CachyOS Optimization: Logic includes automatic detection of the CachyOS kernel to resolve and install the appropriate LLVM/Clang headers instead of generic linux-headers.
- System-Native Dependency Management: Installation scripts prefer pacman-managed Python packages (pyside6, requests) over pip to maintain system integrity and avoid environment conflicts.
- Conflict Mitigation: Automatically handles the blacklisting of the legacy acer_wmi module to ensure the linuwu_sense driver retains exclusive control over hardware registers.
- Universal Shell Support: Includes native installation and uninstallation logic for both Bash and Fish shells.
Installation Procedures
Ensure you have an active internet connection and that your system is up to date before running the installer.
Fish Shell Users
./setup.fish
Bash and Other Shell Users
./install.sh
Verification and Validation
After installation, verify the state of the system using the following commands:
- Driver Status: Run
dkms statusto confirmlinuwu-senseis listed asinstalled. - Kernel Module: Run
lsmod | grep linuwu_senseto ensure the module is actively loaded. - Application Daemon: Run
systemctl --user status damx-daemonto confirm the background manager is active.
Uninstallation
To safely revert all system modifications, including the removal of DKMS modules, blacklists, and application data:
Fish Shell
./uninstall.fish
Bash Shell
./uninstall.sh
Technical Notes
- Secure Boot: If Secure Boot is enabled, you must manually sign the linuwu_sense module or disable Secure Boot to allow the kernel to load the driver.
- Hardware Support: This suite is intended for Acer laptops that utilize the WMI interface for fan and RGB control. Installation on unsupported hardware will result in a compatibility warning.
Maintained for the Acer Linux Community.