HYPRSUNSET(1)

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.