https://github.com/hspak/brightnessztl
A CLI to control device backlight
https://github.com/hspak/brightnessztl
brightnessctl brightnessztl
Last synced: 4 months ago
JSON representation
A CLI to control device backlight
- Host: GitHub
- URL: https://github.com/hspak/brightnessztl
- Owner: hspak
- License: mit
- Created: 2019-08-25T03:43:52.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2025-09-20T19:59:56.000Z (9 months ago)
- Last Synced: 2025-11-22T08:02:08.857Z (7 months ago)
- Topics: brightnessctl, brightnessztl
- Language: Zig
- Size: 44.9 KB
- Stars: 10
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-zig - hspak/brightnessztl - A CLI to control device backlight. (Systems Programming / Embedded Development)
README
# Brightnessztl
A CLI to control device backlight. It defaults to the `intel_backlight` class.
## Setup
```sh
# development tracks the latest stable zig release (0.13.0)
zig build
```
## Usage
```
brightnessztl [action-options]
Actions:
get: Display current brightness
set: Update the brightness
debug: Display backlight information
help: Display this
Set options:
X: Increase brightness to X%
+X: Increase brightness by X%
-X: Decrease brightness by X%
max: Set brightness to maximum
min: Set brightness to minimum
```
By default, `brightnessztl` now links in `libsystemd` to leverage the D-Bus C
API to allow setting backlight values without root permissions or udev rules.
(h/t https://github.com/joachimschmidt557)
To disable this behavior, you can build via `zig build -Dlogind=false`.
`brightnessztl` will require either root access or the following udev rules to
run:
```
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="intel_backlight", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="intel_backlight", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"
```
## Install
Available on Arch Linux via [AUR](https://aur.archlinux.org/packages/brightnessztl/)
## License
MIT