HYPRSUNSET(1)

📦 version 0.4.0, in ubuntu stonking

✨ HYPRSUNSET(1) ✨

okay bestie, welcome to the hyprsunset page of your General Commands Manual 🫶 this is the whole thing, every flag, every default, no skips, i promise.

🌸 NAME 🌸

hyprsunset — blue-light and gamma filter utility for Hyprland 💖

🎀 SYNOPSIS 🎀

hyprsunset [OPTIONS]

🦋 DESCRIPTION 🦋

so hyprsunset is a lil lightweight utility that applies a blue-light filter and a gamma adjustment inside the Hyprland compositor. it's giving cozy evening vibes only 🌙

and here's the iconic part: unlike all those shader-based solutions, its adjustments are not captured in screenshots or screen recordings. your screen recordings stay crisp, no cap 🔥

what it provides:

  • Color temperature control (that's the blue-light reduction part) 🌈
  • Gamma adjustment (perceived brightness beyond hardware limits) ✨
⚠️ gamma adjustments may degrade color accuracy. hardware brightness control should be preferred when it's available, bestie. don't come for me, i'm just the messenger 💀
📌 Supported since Hyprland 0.45.0.

💅 CONFIGURATION 💅

the config file lives here:

~/.config/hypr/hyprsunset.conf

it's optional but recommended — like skincare, you don't have to, but you should 🧖

configuration works 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. clock in, glow up ⏰✨

👑 GLOBAL OPTIONS 👑

  • max-gamma — maximum allowed gamma percentage (the absolute maximum is 200). Default: 100.

🌺 PROFILES 🌺

profiles are defined like this:

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 gets 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, main character energy:

exec-once = hyprsunset

or via systemd user service, if that's more your vibe:

systemctl --user enable --now hyprsunset.service
💡 command-line options override the active profile until the next profile activation. so like, they get the final say until the clock says otherwise ⏳

✨ 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. it will yap 🗣️
  • -v, --version — display version information.
  • -h, --help — display help information.

🧚 IPC 🧚

you can control hyprsunset at runtime using hyprctl, bestie. live adjustments, no restart, we love to see it 💖

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 it's available. heard? 👀

💜 SOURCE 💜

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

and that's the whole page, periodt 💅 you've officially read the hyprsunset entry from the General Commands Manual, filed under HYPRSUNSET(1) — go forth and protect those eyeballs, queen 👑🌸💖

📦 where this page comes from