red-level
red-level is a small command-line utility for software display dimming and
independent red, green, and blue channel control.
It supports macOS, Windows, and Linux/X11. On macOS and Linux, invoking the utility starts a detached background process by default.
Build
Install Rust, clone the repository, and build a release binary:
The installer builds a release binary and copies it to a user-local directory
without sudo:
- macOS and Linux:
$XDG_BIN_HOMEor~/.local/bin - Windows under Git Bash, MSYS2, or Cygwin:
%LOCALAPPDATA%\red-level\bin
Override the destination when needed:
RED_LEVEL_INSTALL_DIR="/bin"
To build without installing, run cargo build --release. The binary is
written to target/release/red-level (red-level.exe on Windows).
Linux builds require the X11 and XRandR development libraries. For example:
# Debian and Ubuntu
# Fedora
# Arch Linux
Usage
Running red-level without a lifecycle option starts the filter in the
background. If it is already running, the existing process is stopped and
replaced.
# Start with all channels at full strength
# Start using only one color channel
# Set independent RGB levels from 0 to 100 percent
# Combine channel levels with overall software brightness
# Stop the background process and restore the display
# Restore the default gamma curves without managing the process
--red-only and its short form, -r, are retained as aliases for --red.
The channel preset flags and --levels are mutually exclusive.
Options
| Option | Description |
|---|---|
-b, --brightness <1-100> |
Set overall software brightness. |
-r, --red-only |
Use only the red channel. |
--red |
Use only the red channel. |
--green |
Use only the green channel. |
--blue |
Use only the blue channel. |
--levels <RED> <GREEN> <BLUE> |
Set each channel from 0 to 100 percent. |
--start |
Explicitly start or restart the detached process. |
--stop |
Stop the detached process and restore the display. |
--reset |
Restore standard brightness and color levels. |
Platform notes
- macOS: Uses CoreGraphics display transfer tables.
- Windows: Uses GDI device gamma ramps. Background process management is currently unavailable.
- Linux: Uses X11 RandR gamma ramps and requires an active X11 display. Native Wayland compositors are not currently supported.
Display servers, HDR modes, color-management services, and graphics drivers may override software gamma changes.
Comparison to similar tools
red-level occupies a fairly unique niche: it's the only actively maintained,
open-source Rust crate offering true cross-platform (macOS, Windows, and
Linux) gamma-based dimming with independent RGB channel control and
background daemon management, embeddable as a library or used as a CLI.
| Tool | macOS | Windows | Linux | License | Notes |
|---|---|---|---|---|---|
| red-level | ✅ (CoreGraphics) | ✅ (GDI gamma ramp) | ✅ (X11/XRandR) | Open source | Rust crate + CLI; independent RGB levels, brightness, background daemon |
| f.lux | ✅ | ✅ | ✅ | Proprietary | GUI-first, closed source, not embeddable as a library |
| Redshift | ❌ | ❌ | ✅ (X11) | Open source (GPL) | Classic color-temperature adjuster; Linux/BSD only |
| gammastep | ❌ | ❌ | ✅ (X11 + Wayland) | Open source (GPL) | Redshift fork with Wayland support; Linux only |
| nightlight (crate) | ✅ | ❌ | ❌ | Open source | Thin CLI wrapper around macOS Night Shift API |
| nvcli (crate) | ❌ | ✅ | ❌ | Open source | Controls NVIDIA Control Panel display settings; Windows only |
| hyprlux (crate) | ❌ | ❌ | ✅ (Hyprland) | Open source | Vibrance/night light control, Hyprland/Wayland only |
Everything besides red-level and f.lux is locked to a single platform, and
f.lux itself is closed source and not usable as a library dependency.