Skip to content

zehratullayl/Linux-Predator-GUI

Repository files navigation

OpenSense v1

Opening Note

If anyone likes this sotware please help me out by creating an icon for this project. I would be needing it for the next build as I will be making this into a package. I'm targetting snap and deb.

If you are capable of making an icon, then please reach out to me here on Github or mail at zehratullayl@gmail.com

Open Source Linux Implementation of Acer PredatorSense

Here is the Kernel Module GitHub Link

Acer Predator RGB keyboard backlight and Turbo mode linux kernel module

https://github.com/JafarAkhondali/acer-helios-300-rgb-keyboard-linux-module

Installation Instructions for New Users

Make sure you have nodejs, npm, and git installed.

  1. git clone https://github.com/zehratullayl/Linux-Predator-GUI.git
  2. cd Linux-Predator-GUI/
  3. sudo ./install.sh
  4. sudo npm -g install electron

⚠️ If electron fails to install then run sudo npm -g install electron --unsafe-perm=true

  1. npm install

Installation Instructions for Existing Users

Navigate to Linux-Predator-GUI folder

  1. git pull
  2. npm install
  3. sudo ./install.sh

Launch Instructions

electron .

NOTE: If for some reason on reboot or boot your keyboard defaults to blue or the color is not responding to your selection or previous selections, please run sudo ./install.sh before running launch command or have a look at Known bugs

What's New In Version 1.0

  1. Added RGB Color Selector along with sliders for selecting color
  2. Added Persistence so your previous preferences load up on starting the application
  3. Removed Apply Button, all changes are now updated live without any need to click Apply button
  4. Added Brightness Control and Neon Mode.
  5. Added Support for Directions in Wave Mode.
  6. Bug Fixes
  7. Updated Core Libraries to latest commits by Jafar Akhondali

Limitations of Version 1.0

  1. Only Zoom, Breathe, Neon and Wave Modes available for now. Version 2.0 will be releasing next week with Static and Shifting Modes

Upcoming Releases

  • New Icon

Please look at Opening Note

  • Snap and Deb packages
  • Light Mode Support
  • Profiles
  • Shift and Static Modes
  • Auto updating

Known bugs

If the keyboard color is not responding

Solution

  1. close the app
  2. sudo ./uninstall.sh
  3. sudo rm /dev/acer-gkbbl-0
  4. sudo ./install.sh

If installation is failing with something like

make[1]: *** /lib/modules/5.11.0-27-generic/build: No such file or directory. Stop.

Solution

For Debian Based Systems

  1. uname -r
  2. copy output of the command
  3. sudo apt-get install linux-headers-<paste here>
  4. Proceed to installation Process

For RPM Based Systems

  1. sudo dnf install kernel-devel kernel-headers