Hyprsunset Dimming

The laptop host has a gamma-only dimming layer built around hyprsunset. It is separate from normal panel brightness and does not enable a warm night-light profile by default.

Use it when the display is still too bright at low hardware brightness, especially in a dark room.

Host scope

The dimming key bindings are in the laptop host override:

~/.config/hypr/host/bindings.conf

The public source is:

~/.config/dotfiles/hypr/.config/hypr/hosts/laptop/bindings.conf

The shared and desktop hyprsunset.conf keep an identity profile so hyprsunset does nothing to the screen unless a helper changes gamma.

Controls

Binding	Action
SUPER+CTRL+D	Toggle dim mode.
SUPER+CTRL+-	Dim down.
SUPER+CTRL+=	Dim up.
CTRL+BrightnessDown	Dim down.
CTRL+BrightnessUp	Dim up.
BrightnessDown	Clear dimming, then lower hardware brightness.
BrightnessUp	Clear dimming, then raise hardware brightness.

Normal brightness keys clear dim mode first so a screen is not accidentally left gamma-dimmed after increasing hardware brightness.

State files

The helper scripts keep state under:

~/.config/hypr/.state/

File	Meaning
hyprsunset-dim-enabled	Present when dim mode is active.
hyprsunset-dim-level	Last gamma level written by the helper.

The default toggle level is 50. Dim steps move by 5, clamped between 5 and 100.

Commands

Toggle dim mode:

~/.config/hypr/bin/hyprsunset-toggle-dim

Dim down or up:

~/.config/hypr/bin/hyprsunset-dim-step down
~/.config/hypr/bin/hyprsunset-dim-step up

Clear dim mode:

~/.config/hypr/bin/hyprsunset-clear-dim

Each helper starts hyprsunset with the active host config if it is not already running.

Check current state

pgrep -x hyprsunset
hyprctl hyprsunset gamma
ls ~/.config/hypr/.state

If hyprctl hyprsunset gamma reports 100, dim mode is effectively off.

Troubleshooting

If the keys do nothing, confirm the active host is laptop and the host symlink points at the laptop overrides. See Host Overrides.

If dim mode gets stuck, clear it explicitly:

~/.config/hypr/bin/hyprsunset-clear-dim

If hyprsunset is not running after login, check the laptop autostart override. It starts:

uwsm app -- hyprsunset --config ~/.config/hypr/host/hyprsunset.conf

Night-light profiles

The laptop host config includes commented examples for temperature or scheduled gamma profiles, but they are not active. Keep them commented unless you want automatic colour or gamma changes in addition to the manual dim controls.