7 releases (4 breaking)

0.5.0 Sep 10, 2022
0.4.1 Jan 30, 2022
0.3.1 Nov 1, 2021
0.3.0 Sep 5, 2021
0.1.0 Jul 28, 2021

#398 in Unix APIs

Download history 155/week @ 2024-11-15 183/week @ 2024-11-22 237/week @ 2024-11-29 375/week @ 2024-12-06 327/week @ 2024-12-13 45/week @ 2024-12-20 143/week @ 2024-12-27 370/week @ 2025-01-03 218/week @ 2025-01-10 540/week @ 2025-01-17 152/week @ 2025-01-24 99/week @ 2025-01-31 100/week @ 2025-02-07 102/week @ 2025-02-14 114/week @ 2025-02-21 102/week @ 2025-02-28

432 downloads per month
Used in 2 crates

0BSD license

48KB
958 lines

Overview

This crate provides definitions to get and set display brightness.

Linux and Windows are supported.

Example

use brightness::Brightness;
use futures::TryStreamExt;

async fn show_brightness() -> Result<(), brightness::Error> {
    brightness::brightness_devices().try_for_each(|dev| async move {
        let name = dev.device_name().await?;
        let value = dev.get().await?;
        println!("Brightness of device {} is {}%", name, value);
        Ok(())
    }).await
}

Linux

This crate interacts with devices found at /sys/class/backlight. This means that the ddcci-backlight kernel driver is required to control external displays (via DDC/CI).

Setting brightness is attempted using D-Bus and logind, which requires systemd 243 or newer. If this fails because the method is not available, the desired brightness is written to /sys/class/backlight/$DEVICE/brightness, which requires permission (udev rules can help with that).

Contribute

All contributions shall be licensed under the 0BSD license.

Dependencies

~0.6–43MB
~617K SLoC