Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.
BrightWheel
BrightWheel is a small Windows tray app for controlling an external monitor's brightness over DDC/CI. It uses the Windows monitor API directly, so it does not require vendor software.
From the tray icon you can:
- see the current brightness as an icon color from gray (0%) to yellow (100%);
- scroll to change the primary monitor's brightness;
- double-click to turn off all monitors immediately;
- middle-click to toggle HDR;
- enable or disable startup with Windows;
- check for a new release, update in place, and automatically restart;
- exit the app.
Scrolling accelerates from precise 2% steps to 10% steps during a continuous gesture. Startup with Windows is enabled on first launch and can be disabled from the tray menu.
Requirements
- 64-bit Windows 10 or 11 for the prebuilt release;
- an external monitor with DDC/CI enabled in its on-screen settings;
- Windows and monitor support for HDR toggling.
Install
Download brightwheel.exe from the
latest release and run it.
The executable is self-contained, but unsigned releases may trigger a Windows
SmartScreen warning on first launch.
Updating without manually exiting
Right-click the tray icon and select Check for updates. BrightWheel checks
the latest stable GitHub Release and, if it is newer, downloads and verifies
its executable assets against GitHub's SHA-256 digests and byte sizes.
A detached PowerShell helper then asks the running tray process to exit,
replaces brightwheel.exe (and the optional co-located bright.exe CLI),
and restarts the tray. The previous executables are preserved for rollback
if replacement or restart fails.
The updater requires Windows PowerShell 5.1, HTTPS access to GitHub, and
write access to the installation directory. It is manually initiated and
does not periodically check for updates. The local update log is at
%LOCALAPPDATA%\BrightWheel\updater.log. No monitor data is uploaded.
When installing with cargo install brightwheel --force instead, a running
executable still needs to be closed before Cargo can overwrite it.
Alternatively, install both the tray app and CLI with Rust:
cargo install brightwheel --locked
Command line
The optional bright.exe companion is intended for diagnostics and scripts:
bright list
bright get [MONITOR]
bright set PERCENT [MONITOR]
bright change DELTA [MONITOR]
bright capabilities [MONITOR]
bright hdr
bright hdr-toggle
PERCENT is a brightness value from 0 to 100. [MONITOR] is an optional
numeric index printed by bright list; do not type the square brackets. If the
index is omitted, monitor 0 is used.
For example:
bright get # read brightness from monitor 0
bright get 1 # read brightness from monitor 1
bright set 65 1 # set monitor 1 to 65%
bright change -5 # lower monitor 0 by 5%
Build
Build from a Windows shell with Rust 1.85 or newer and the Windows SDK installed
(rc.exe is required for the tray icon):
cargo build --release --locked
The binaries are written to target\release\brightwheel.exe and
target\release\bright.exe.
Run the project checks with:
cargo fmt --all -- --check
cargo clippy --all-targets --locked -- -D warnings
cargo test --all-targets --locked
Hardware-independent behavior is covered by automated tests. DDC/CI and HDR still require manual testing with a compatible monitor.