Skip to content

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:

image image

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

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%