110 lines
2.5 KiB
Markdown
110 lines
2.5 KiB
Markdown
% 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/)
|