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

#875 in Hardware support

Download history 2/week @ 2023-11-20 4/week @ 2023-11-27 1/week @ 2023-12-04 1/week @ 2023-12-18 12/week @ 2023-12-25 17/week @ 2024-01-01 104/week @ 2024-01-08 117/week @ 2024-01-15 29/week @ 2024-01-22 13/week @ 2024-01-29 9/week @ 2024-02-12 29/week @ 2024-02-19 54/week @ 2024-02-26 26/week @ 2024-03-04

118 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.7–49MB
~719K SLoC