% 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:

```text
$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)](https://man.archlinux.org/man/redshift.1),  
[gammastep(1)](https://man.archlinux.org/man/gammastep.1),  
[hyprctl(1)](https://wiki.hyprland.org/Options/)