NAME¶

hyprsunset - blue-light and gamma filter utility for Hyprland

SYNOPSIS¶

hyprsunset [OPTIONS]

DESCRIPTION¶

hyprsunset is a lightweight utility for applying a blue-light filter and gamma adjustment within the Hyprland compositor.

Unlike shader-based solutions, its adjustments are not captured in screenshots or screen recordings.

It provides:

- Color temperature control (blue-light reduction)

- Gamma adjustment (perceived brightness beyond hardware limits)

Gamma adjustments may degrade color accuracy. Hardware brightness control should be preferred when available.

Supported since Hyprland 0.45.0.

CONFIGURATION¶

Configuration file:

~/.config/hypr/hyprsunset.conf

The configuration file is optional but recommended.

Configuration is based on profiles. Each profile activates at a specified time and overrides previous settings.

On startup, the profile matching the current system time is applied.

GLOBAL OPTIONS¶

max-gamma

Maximum allowed gamma percentage (absolute maximum: 200). Default: 100.

PROFILES¶

Profiles are defined as:

profile {


  time = HH:MM


  temperature = INTEGER


  gamma = FLOAT


  identity = BOOLEAN
}

time

Activation time in 24-hour format.

temperature

Color temperature in Kelvin (lower values are warmer). Default: 6000.

gamma

Perceived brightness multiplier. Default: 1.0.

identity

Disables color temperature adjustment; only gamma is applied. Default: false.

EXAMPLE¶

max-gamma = 150
profile {


  time = 7:30


  identity = true
}
profile {


  time = 21:00


  temperature = 5500


  gamma = 0.8
}

USAGE¶

Autostart via Hyprland:

exec-once = hyprsunset

Or via systemd user service:

systemctl --user enable --now hyprsunset.service

Command-line options override the active profile until the next profile activation.

OPTIONS¶

-g, --gamma

Set display gamma (percentage, default 100).

--gamma_max

Set maximum allowed gamma (percentage, max 200).

-t, --temperature

Set color temperature in Kelvin (default 6000).

-i, --identity

Disable color transformation (gamma only).

--verbose

Enable verbose logging.

-v, --version

Display version information.

-h, --help

Display help information.

IPC¶

hyprsunset can be controlled at runtime using hyprctl:

Enable blue-light filter:

  hyprctl hyprsunset temperature 2500

Disable blue-light filter:

  hyprctl hyprsunset identity

Set gamma:

  hyprctl hyprsunset gamma 50

Adjust gamma:

  hyprctl hyprsunset gamma +10

Reset to profile:

  hyprctl hyprsunset reset

Reset individual values:

  hyprctl hyprsunset reset temperature


  hyprctl hyprsunset reset gamma


  hyprctl hyprsunset reset identity

Show current profile:

  hyprctl hyprsunset profile

NOTES¶

Gamma manipulation reduces color accuracy. Prefer hardware brightness control where available.

SOURCE¶

This manual page is based on documentation from https://wiki.hypr.land/Hypr-Ecosystem/hyprsunset.