Div Acer Manager Max (DAMX) - Rust Edition 🦀

An ultra-fast, lightweight, and modern Linux hardware manager for Acer Predator and Acer Nitro laptops, rewritten entirely in Rust with Slint UI and D-Bus.

Designed as a native drop-in replacement for the Acer PredatorSense / NitroSense Windows utilities, working in tandem with the linuwu-sense kernel driver.

---

🌟 Key Features

• ⚡ Full Rust Architecture: Zero runtime overhead, rock-solid memory safety, instant startup, and tiny memory footprint.
• 🎛️ D-Bus System Service (org.linuwu.Sense): Secure non-root client/daemon communication over the system bus, with automatic fallback to /var/run/DAMX.sock.
• 📊 Real-time Hardware Telemetry: Live CPU/GPU temps and usage (NVIDIA, AMD, Intel), fan tachometer RPMs, system RAM, and battery charging stats.
• 🚀 Thermal Profiles: Instant switching between Quiet / Eco, Balanced, Performance, and Turbo via ACPI platform_profile.
• 🌪️ Fan Speed Control: Automatic, Max (100%), and granular independent Manual CPU / GPU fan curves.
• 🌈 4-Zone Keyboard RGB Lighting:
  • Direct hardware support for ENEK5130 I2C/HID RGB microcontrollers (/dev/hidraw* HIDIOCSFEATURE ioctls) as well as driver sysfs VFS.
  • Per-zone hex colors and brightness control.
  • Dynamic hardware lighting modes: Breathing, Neon, Wave, Shifting, Zoom, Meteor, and Twinkling.\
• 🔋 Battery Care & Health:
  • 80% charge threshold limiter to extend battery lifespan.
  • One-click battery gauge calibration.
• 🛠️ Acer Hardware Toggles:
  • Keyboard backlight 30-second sleep timeout.
  • LCD display overdrive (3ms fast response).
  • Power-on boot animation audio chime.
  • USB power-off device charging levels (0%, 10%, 20%, 30%).
• ⌨️ Hardware Dedicated Sense Key: Background evdev monitor for keycode 425 launches the GUI under the active desktop user.
• 🖥️ Modern Slint Desktop GUI (damx-gui): Responsive, reactive, dark gaming-themed UI designed for KDE, GNOME, and Wayland/X11.
• 💻 Feature-Rich CLI (damx): Fast command-line interface with interactive live terminal dashboard.

---

📦 Workspace Architecture

Div-Acer-Manager-Max/
├── PKGBUILD                # Arch Linux / AUR package build recipe
├── damx.install            # Pacman installation hooks & post-install scripts
├── package_arch.sh         # One-step Arch Linux .pkg.tar.zst packager
├── damx.spec               # Red Hat / Fedora RPM packaging specification
├── package_rpm.sh          # One-step RPM build and packager
├── install.sh              # Standalone installer script
├── Cargo.toml              # Root Cargo workspace manifest
├── crates/
│   ├── damx-core/          # Hardware drivers, ENEK5130 HID, modprobe, telemetry, D-Bus & socket client
│   ├── damx-daemon/        # Root system daemon (D-Bus `org.linuwu.Sense`, socket `/var/run/DAMX.sock`, evdev hotkey)
│   ├── damx-cli/           # Command-line interface tool (`damx`)
│   └── damx-gui/           # Modern desktop GUI application powered by Slint (`damx-gui`)
└── data/
    ├── org.linuwu.Sense.conf   # D-Bus security policy
    ├── damx-daemon.service     # Systemd unit file
    ├── damx-gui.desktop        # Desktop launcher entry
    └── damx-gui.png            # Application icon

---

🚀 Packaging & Installation

Option 1: Arch Linux / CachyOS / EndeavourOS / Manjaro (.pkg.tar.zst)

Build the Arch package:

./package_arch.sh

Install via pacman:

sudo pacman -U target/arch/damx-2.0.0-1-x86_64.pkg.tar.zst

Or build with standard makepkg:

makepkg -si

---

Option 2: Fedora / RHEL / openSUSE (.rpm)

Build the RPM package:

./package_rpm.sh

Install via dnf:

sudo dnf install target/rpmbuild/RPMS/x86_64/damx-2.0.0-1.fc44.x86_64.rpm

---

Option 3: Script Installer

./install.sh

---

💻 CLI Usage (damx)

# View complete status and telemetry
damx status

# Live terminal monitor
damx monitor

# Change thermal profile
damx profile balanced
damx profile performance
damx profile quiet

# Control fans
damx fan auto
damx fan max
damx fan manual 80 80

# Keyboard RGB controls
damx rgb static 00f0ff --brightness 100
damx rgb zones ff0000 00ff00 0000ff ffff00
damx rgb effect 1 --speed 5 --color 00f0ff

# Battery management
damx battery --limiter true
damx battery --calibrate true

# Acer system features
damx system --backlight false
damx system --lcd true
damx system --sound false
damx system --usb 20

# Driver management
damx driver --force predator
damx driver --force nitro
damx driver --restart

---

📄 License

This project is licensed under the GPL-3.0 License.