HINOIRISETR(1)

💖 HINOIRISETR(1) 💖

okay so bestie, this is hinoirisetr from the General Commands Manual — she's a little daemon and she's so good at her job, like genuinely. sit down, get comfy, let's go 🫶

---

✨ NAME ✨

hinoirisetr — adaptive screen dimming daemon with runtime control 🎀

---

✨ SYNOPSIS ✨

hinoirisetr COMMAND OPTIONS

---

✨ DESCRIPTION ✨

so hinoirisetr is a daemon that automatically adjusts screen color temperature and gamma based on time of day. like she just knows what time it is and she's adjusting. no cap. she supports multiple backends and gives you live configuration reload plus runtime control via a Unix socket. main character energy fr 💅

When launched without arguments, here's the little routine she does:

1. Loads TOML configuration from the default path
2. Applies settings according to local time
3. Watches for config changes every 5 seconds
4. Listens on a Unix socket for control commands

Environment variables you should know about:

• RUST_LOG — sets the log level (trace|debug|info|warn|error). heads up: trace and debug are unavailable in release builds 🙈
• XDG_CONFIG_HOME — custom config directory

---

✨ OPTIONS ✨

• -v, —version — shows version information and then exits. iconic, brief, done. ⭐

---

✨ CONFIGURATION ✨

Configuration uses TOML format, found at:

$XDG_CONFIG_HOME/hinoirisetr.toml
# or ~/.config/hinoirisetr.toml

If it's not found, defaults are used with a warning. not her fault, she tried 😭

🦋 Global Options 🦋

• notification_timeout — timeout in milliseconds for desktop notifications.
• disable_timeout — timeout in seconds after which hinoirisetr turns itself up after calling toggle or disable commands.
• gamma_backend — one of: ddcutil, wayland, xsct, acpi, none. Or you can specify up to 3, using array syntax: ["backend1", "backend2"]
• temp_backend — one of: wayland, xsct, none. Or you can specify up to 3, using array syntax: ["backend1", "backend2"]

🌸 Section [gamma] 🌸

• day — gamma percentage for daytime (0–100).
• night — gamma percentage for nighttime (0–100).

🌸 Section [temp] 🌸

• day — color temperature in Kelvin for daytime (1000–20000).
• night — color temperature in Kelvin for nighttime (1000–20000).

🌸 Section [time] 🌸

Interpolation options, these are the glow-up settings:

• interpolation_temp
• interpolation_gamma

available options for those: linear, cubic, cubiceaseinout, cosine, exponential

Values in time (HH:MM):

• sunset_start
• sunset_end
• sunrise_start
• sunrise_end

---

✨ CONTROL SOCKET ✨

there's a Unix socket at /tmp/hinoirisetr-$USER.sock and it accepts newline-terminated commands. she's listening, always 💜

• disable — pause automatic adjustments; sets day settings.
• disable_temp — pause automatic temperature adjustments; sets day settings.
• disable_gamma — pause automatic gamma adjustments; sets day settings.
• enable — resume automatic adjustments.
• enable_temp — resume automatic temperature adjustments.
• enable_gamma — resume automatic gamma adjustments.
• toggle — switch between enabled/disabled states.
• toggle_temp — switch between enabled/disabled temperature adjustments.
• toggle_gamma — switch between enabled/disabled gamma adjustments.
• status — returns current state: dimming is <enabled|disabled> – temp: <K>K, gamma: <%>
• reload — force immediate config reload.
• reload_full — force immediate config reload and also restart the backend threads. the full send 🔥
• status_notify — send desktop notification with current settings (or “disabled”).

---

✨ COMMAND ✨

Accepts the same commands as CONTROL SOCKET ⬆️

If ran with no command then launches the daemon.

---

✨ FILES ✨

• Configuration: $XDG_CONFIG_HOME/hinoirisetr.toml
• Socket: /tmp/hinoirisetr-$USER.sock

---

✨ SIGNALS ✨

• SIGINT/SIGTERM — clean shutdown (removes socket file). she cleans up after herself, we love a tidy queen 🧚

⚠️ ngl, this is the clean way out — she removes her socket file on the way, so let her go properly.

---

✨ SEE ALSO ✨

hyprctl(1)

---

✨ BUGS ✨

Report issues at https://git.vavakado.xyz/me/hinoirisetr — bestie pls, she wants to hear from you 💀

---

✨ AUTHORS ✨

Vladimir Rubin <xor@vavakado.xyz> 👑

---

and that's the whole page, bestie — go forth and dim responsibly ✨ this lil beauty ships as part of the General Commands Manual (source: HINOIRISETR(1)) and the date on the tin is 1980-01-01 🎀💖🦋