hinoirisetr/manpages/hinoirisetr.1.md

% hinoirisetr(1) % Vladimir Rubin % May 2025

NAME

hinoirisetr — automatic display gamma & temperature adjuster with live config reload and control socket

SYNOPSIS

hinoirisetr [options]

DESCRIPTION

hinoirisetr runs as a daemon that automatically adjusts display gamma and color temperature based on time of day. When launched without arguments:

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

Environment variables:

• RUST_LOG - Set log level (e.g., export RUST_LOG=debug)

CONFIGURATION

The config file uses INI-style syntax with sections and key-value pairs. Comments begin with #. Default location:

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

If not found, the daemon emits a warning and uses built-in defaults.

Global Options

• notification_timeout
  Timeout in milliseconds for desktop notifications.

• gamma_backend
  One of: hyprctl, ddcutil, gammastep, xsct, redshift, none.

• temp_backend
  One of: hyprctl, gammastep, xsct, redshift, none.

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]

All values in hours (0–23):

• sunset_start
• sunset_end
• sunrise_start
• sunrise_end

CONTROL SOCKET

Unix socket at /tmp/hinoirisetr.sock accepts newline-terminated commands:

• disable
  Pause automatic adjustments; keeps current settings.

• enable
  Resume automatic adjustments.

• toggle
  Switch between enabled/disabled states.

• status
  Returns current state:
  dimming is <enabled|disabled> – temp: <K>K, gamma: <%>

• reload
  Force immediate config reload.

• status_notify
  Send desktop notification with current settings (or "disabled").

FILES

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

SIGNALS

• SIGINT/SIGTERM
  Clean shutdown (removes socket file).

SEE ALSO

redshift(1),
gammastep(1),
hyprctl(1)