added applet and updated README

This commit is contained in:
2026-02-06 18:56:26 +02:00
parent e80a77f30b
commit c7e4798771
7 changed files with 352 additions and 4 deletions

View File

@@ -1,5 +1,7 @@
# acer-lighting
> **Fork Notice:** This is a fork of [fcrespo82/acer-lighting-daemon](https://github.com/fcrespo82/acer-lighting-daemon) with added GUI tray applet support.
**Thanks**
This project benefited greatly from the work, testing and research of several community contributors — especially: @ZoeBattleSand, @0x189D7997, and @JakeBrxwn. Their reverse-engineering, testing, tooling and discussion (see https://github.com/0x7375646F/Linuwu-Sense/pull/65) made much of this possible.
@@ -7,7 +9,7 @@ This project benefited greatly from the work, testing and research of several co
Small tools to control Acer laptop RGB zones and a daemon that persists/apply states.
> [!CAUTION]
> The code here was based on the work of others but it was written with the help of AI too
> The code here was based on the work of others but it was written with the help of AI too
## Build
@@ -48,6 +50,41 @@ If you need to undo the install:
sudo make uninstall
```
## GUI Tray Applet
A system tray applet is included for easy RGB control without using the command line.
### Dependencies
```sh
sudo apt install python3-gi gir1.2-appindicator3-0.1
```
### Running
```sh
python3 acer-rgb-tray.py
```
The applet appears in your system tray. Click it to access:
- **Color presets** (Red, Green, Blue, White, Cyan, Magenta, Yellow, Orange)
- **Custom...** - Opens a full color picker dialog
- **Effect** submenu - Static, Breathing, Neon, Wave, Ripple, Zoom, Snake, Disco, Shifting
### Autostart
To start the applet automatically on login:
```sh
cp acer-rgb-tray.desktop ~/.config/autostart/
```
Make sure the daemon is running before the applet starts:
```sh
sudo systemctl enable acer-rgbd.service
```
## Usage
- Send commands to the daemon using the `acer-rgb` helper (it talks to the daemon socket):
@@ -85,3 +122,4 @@ sudo systemctl restart acer-rgbd.service
- The installer writes an initial all-green state (keyboard/lid/button) to `/var/lib/acer-rgbd/state.txt` so newly installed systems show green LEDs by default.
- Running the daemon requires root privileges (or appropriate udev rules) to access the HID device.
- The GUI applet communicates with the daemon via socket (`/run/acer-rgbd.sock`) and runs as a regular user.