Dark Mode

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Bring full PredatorSense functionality to Linux with this kernel module + CLI tool. Unlock Turbo mode, RGB lighting, and advanced fan control & Fan Curvers on Acer Predator & Nitro laptops.

License

Notifications You must be signed in to change notification settings

Order52/linuwu-sense-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

64 Commits

Repository files navigation

A streamlined Bash-based frontend for managing PredatorSense-like features on Linux systems, using the Linuwu-Sense kernel module.

Fork of 0x7375646F/Linuwu-Sense
Huge thanks to sudo / 0x7375646F for bringing

More info

https://github.com/0x7375646F/Linuwu-Sense

PredatorSense to Linux!

This launcher script was developed (with some help from AI) to provide a clean, user-friendly, menu-driven interface for configuring system-level features via the linuwu_sense kernel module.

Tested on:

Acer Predator Helios 16 Model: PH16-71

Preview

Here's what the tool looks like in action:

Predator Key

You can also check out how bind the Predator Key on your keyboard here https://github.com/Order52/Predator-Key

A new Python-based fan control utility is now included. It provides profile-based and dynamic fan control through the Linuwu-Sense interface.

Features :

  • gaming profile: maximum cooling for performance
  • quiet profile: prioritizes low noise
  • balanced profile: optimized for general use
  • Daemon mode for continuous monitoring
  • View current status and configuration
  • Edit config for custom behavior
  • Easily control and monitor:
  • Advanced Fan Curve Control

Note: All commands require root (sudo) for now.

Keyboard Backlight Timeout
Battery Charge Limiter
Boot Animation and Sound
Fan Speeds (Auto, Quiet, Balanced, Performance, Turbo, Custom)
LCD Override
USB Charging Thresholds
Battery Calibration

All through a terminal interface, backed by SysFS and requiring root access. Usage

  1. Prerequisites

    Linux kernel module: linuwu_sense.ko Compatible Acer Predator laptop Root privileges (the script will attempt to elevate with sudo)

    You must load the Linuwu-Sense kernel module before using this script.

Step 1: Install Kernel Headers

On Arch Linux:

sudo pacman -S linux-headers

Step 2: Clone and Build the Module

git clone https://github.com/Order52/linuwu-sense-cli.git
cd linuwu-sense-cli
make install

This will remove the default acer_wmi module and load the patched version from Linuwu-Sense. Make sure to run with sudo if needed.

Using Clang Instead?

sudo make CC=clang LD=ld.lld install

To Uninstall

make uninstall

Then Run the Script

chmod +x Linuwu-sense-menu.py
chmod +x fan-curve.py
python Linuwu-sense-menu.py
python ./fan-curve.py

You can also add these to your .bashrc for quick control on the fan curves

fan-gaming() {
sudo python3 fan_curve.py --profile gaming
sudo python3 fan_curve.py --daemon
}

fan-balance() {
sudo python3 fan_curve.py --profile balanced
sudo python3 fan_curve.py --daemon
}

fan-quiet() {
sudo python3 fan_curve.py --profile quiet
sudo python3 fan_curve.py --daemon
}

About

Bring full PredatorSense functionality to Linux with this kernel module + CLI tool. Unlock Turbo mode, RGB lighting, and advanced fan control & Fan Curvers on Acer Predator & Nitro laptops.

Topics

Resources

Readme

License

GPL-3.0 license

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 71.7%
  • Python 18.8%
  • Shell 7.8%
  • Makefile 1.7%