|0.2.1||Nov 14, 2021|
|0.1.3||Jan 9, 2021|
|0.1.2||Dec 15, 2020|
|0.1.0||Dec 11, 2020|
#1996 in Command line utilities
21 downloads per month
OLED displays don't have backlights but it'd be nice if we could pretend they do on Linux!
This program aims to be very light weight and configurable. The easiest way to use it would be to make it run on startup.
The only external dependency is
You can get an x86_64 Linux (ELF) binary from the releases page.
Alternatively, the program is available on the AUR
and on crates.io via
cargo install oled_shmoled.
$ oled_shmoled --help OLED shmoled 0.1.0 Nick Webster <email@example.com> USAGE: oled_shmoled [OPTIONS] <monitor-ident> ARGS: <monitor-ident> The xrandr identifier for the display FLAGS: -h, --help Prints help information -V, --version Prints version information OPTIONS: --base-path <base-path> The base path for the backlight files [default: /sys/class/backlight/intel_backlight] --current-brightness-file <current-brightness-file> The name of the file containing the current backlight state [default: brightness] --max-brightness-file <max-brightness-file> The name of the file identifying the maximum brightness of the system [default: max_brightness]
$ xrandr Screen 0: minimum 8 x 8, current 4608 x 4752, maximum 32767 x 32767 eDP1 connected primary 3840x2160+266+2592 (normal left inverted right x axis y axis) 340mm x 190mm # ...etc...
$ oled_shmoled eDP1 Watching /sys/class/backlight/intel_backlight for backlight changes…
The easiest way to use OLED Shmoled is to run that last command at start-up. This can be done by running it in an
.xinitrc or a systemd job.
On window managers like i3 you can add the following to your i3 configs to get the brightness keys working:
bindsym XF86MonBrightnessDown exec --no-startup-id xbacklight -dec 5 bindsym XF86MonBrightnessUp exec --no-startup-id xbacklight -inc 5
$ git clone https://github.com/NickGeek/oled-shmoled oled_shmoled $ cd oled_shmoled $ cargo build --release