% hinoirisetr(1)
% Vladimir Rubin
% May 2025

# NAME

**hinoirisetr** - adaptive screen dimming daemon with runtime control

# SYNOPSIS

**hinoirisetr** [COMMAND] [OPTIONS]

# DESCRIPTION

**hinoirisetr** is a daemon that automatically adjusts screen color temperature and gamma based on time of day. It supports multiple backends and provides live configuration reload and runtime control via Unix socket.

When launched without arguments:

1. Loads TOML configuration from 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:

- `RUST_LOG` - Set log level (trace|debug|info|warn|error)
- `XDG_CONFIG_HOME` - Custom config directory

# OPTIONS

**-v**, **--version**  
Show version information and exit.

# CONFIGURATION

Configuration uses TOML format at:

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

If not found, defaults are used with warning.

## 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]`

Interpolation options:

- interpolation_temp
- interpolation_gamma
  available options: linear, cubic, cubiceaseinout, cosine, exponential

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; 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.

- **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.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/Hypr-Ecosystem/hyprsunset/)

# BUGS

Report issues at https://git.vavakado.xyz/vavakado/hinoirisetr

# AUTHOR

Vladimir Rubin <xor@vavakado.xyz>
