Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Junker/stumpwm-acpi-backlight
ACPI backlight control module for StumpWM
https://github.com/Junker/stumpwm-acpi-backlight
acpi-brightness stumpwm
Last synced: about 1 month ago
JSON representation
ACPI backlight control module for StumpWM
- Host: GitHub
- URL: https://github.com/Junker/stumpwm-acpi-backlight
- Owner: Junker
- Created: 2022-04-28T06:51:41.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-11-18T15:32:18.000Z (about 1 year ago)
- Last Synced: 2024-08-02T21:38:31.962Z (5 months ago)
- Topics: acpi-brightness, stumpwm
- Language: Common Lisp
- Homepage:
- Size: 4.88 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-stumpwm - acpi-backlight - ACPI backlight control module (Modules)
README
# StumpWM ACPI-Backlight
ACPI backlight control module for StumpWM.
## Installation
```bash
cd ~/.stumpwm.d/modules/
git clone https://github.com/Junker/stumpwm-acpi-backlight acpi-backlight
```
get name of your backlight device:
```bash
$ ls /sys/class/backlight
intel_backlight
```
add lisp code:
```common-lisp
(stumpwm:add-to-load-path "~/.stumpwm.d/modules/acpi-backlight")
(load-module "acpi-backlight")
(acpi-backlight:init "intel_backlight") ; use name of your ACPI backlight device
```
## Usage
```common-lisp
(define-key *top-map* (kbd "XF86MonBrightnessUp") "backlight-up")
(define-key *top-map* (kbd "XF86MonBrightnessDown") "backlight-down")
```
### Additional commands
- `backlight-set value`
### Additional functions
- `get-brightness`
- `get-brightness-pct`
- `set-brightness`
- `set-brightness-pct`
### Parameters
- `acpi-backlight:*step*` - brightness increase/decrease percent step
### Modeline
`%Q` - backlight formatter
#### Modeline mouse interaction
- **wheel up**: brightness up
- **wheel down**: brightness down
## Troubleshooting
Sometimes only `root` can change the brightness by this method. To allow users
in the `video` group to change the brightness, a udev rule such as the following
can be used:
```bash
$ cat /etc/udev/rules.d/backlight.rules
ACTION=="add", SUBSYSTEM=="backlight", RUN+="/bin/chgrp video $sys$devpath/brightness", RUN+="/bin/chmod g+w $sys$devpath/brightness"
```
Then you need to add your user to the video group.
```bash
usermod -aG video
```