日の入りsetr (hinoirisetr)

hinoirisetr is a lightweight daemon that automatically adjusts your screen's color temperature and gamma based on the time of day. It helps reduce eye strain and improve sleep quality by dimming the screen at night. The daemon supports multiple backends for flexibility and can be controlled at runtime via a Unix socket.

Features

• Automatic Screen Adjustment: Adjusts screen temperature and gamma based on the time of day (e.g., warmer at night, cooler during the day).
• Multiple Backends: Supports various backends for controlling screen settings:
  • ddcutil
  • gammastep
  • hyprctl (with hyprsunset)
  • redshift
  • xsct
• Runtime Control: Use a Unix socket to enable, disable, toggle, or reload the configuration without restarting the daemon.
• Configuration Reload: Automatically reloads the configuration file when changes are detected.
• Desktop Notifications: Optionally send notifications with the current status.

Backends

hinoirisetr uses backends to apply screen adjustments. You can choose different backends for temperature and gamma control:

• ddcutil: Controls monitor settings via the DDC/CI protocol (useful for external monitors).
• gammastep: Adjusts screen color temperature and gamma. (temporary, waiting for #2 and will be removed in the future)
• hyprctl: Controls settings in the Hyprland compositor (requires hyprsunset).
• redshift: Adjusts screen color temperature and gamma.
• xsct: Adjusts both screen color temperature and gamma.

Select the appropriate backend based on your system and preferences. Ensure the required binaries are installed and available in your PATH.

Installation

hinoirisetr is written in Rust. To build and install it:

1. Install Rust and Cargo if you haven't already:

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

2. Clone the repository:

   git clone https://git.vavakado.xyz/vavakado/hinoirisetr.git
   cd hinoirisetr
   

3. Build the project:

   cargo install --path .
   

Alternatively, if using Nix, you can use the provided flake:

nix build

Configuration

hinoirisetr uses a TOML configuration file located at:

• $XDG_CONFIG_HOME/hinoirisetr.toml (if XDG_CONFIG_HOME is set)
• ~/.config/hinoirisetr.toml (otherwise)

If no configuration file is found, the daemon will use default settings and log a warning.

Configuration Options

The configuration file supports the following options:

• Global Options:

  • notification_timeout: Timeout in milliseconds for desktop notifications (default: 5000).
  • disable_timeout: Timeout in seconds for disabling adjustments (default: 300).
  • gamma_backend: Backend for gamma control (options: hyprctl, ddcutil, gammastep, xsct, redshift, none).
  • temp_backend: Backend for temperature control (options: hyprctl, gammastep, xsct, redshift, none).

• Section [gamma]:

  • day: Gamma percentage for daytime (0–100, default: 100).
  • night: Gamma percentage for nighttime (0–100, default: 95).

• Section [temp]:

  • day: Color temperature in Kelvin for daytime (1000–20000, default: 6500).
  • night: Color temperature in Kelvin for nighttime (1000–20000, default: 2500).

• Section [time]:

  • sunset_start: Hour (0–23) when sunset starts.
  • sunset_end: Hour (0–23) when sunset ends.
  • sunrise_start: Hour (0–23) when sunrise starts.
  • sunrise_end: Hour (0–23) when sunrise ends.
  • interpolation_temp: Interpolation method for temperature (options: linear, cubic, cubiceaseinout, cosine, exponential).
  • interpolation_gamma: Interpolation method for gamma (same options as above).

Note: The daemon will interpolate settings between day and night during sunrise and sunset periods using the specified interpolation methods.

Example Configuration

notification_timeout = 3000
gamma_backend = "xsct"
temp_backend = "xsct"

[gamma]
day = 100
night = 90

[temp]
day = 6500
night = 3500

[time]
sunset_start = 18
sunset_end = 21
sunrise_start = 5
sunrise_end = 8
interpolation_temp = "cubic"
interpolation_gamma = "linear"

Usage

Starting the Daemon

To start the daemon, simply run:

hinoirisetr

It will load the configuration, check for required backends, and start adjusting the screen settings based on the current time.

Runtime Control via Unix Socket

hinoirisetr listens on a Unix socket at /tmp/hinoirisetr-$USER.sock for control commands. Available commands include:

• status: Prints the current status (e.g., "dimming - temp: 6500K, gamma: 100%").
• status_notify: Sends the current status via a desktop notification.
• enable: Enables automatic adjustments.
• disable: Disables automatic adjustments and sets day settings.
• toggle: Toggles between enabled and disabled states.
• enable_temp: Enables temperature adjustments.
• disable_temp: Disables temperature adjustments.
• toggle_temp: Toggles temperature adjustments.
• enable_gamma: Enables gamma adjustments.
• disable_gamma: Disables gamma adjustments.
• toggle_gamma: Toggles gamma adjustments.
• reload: Reloads the configuration file.

To send a command, use a tool like socat:

echo "toggle" | socat - UNIX-CONNECT:/tmp/hinoirisetr-$USER.sock

Command-Line Interface

You can also send commands directly from the command line without using socat:

hinoirisetr toggle

Logging

Set the RUST_LOG environment variable to control log verbosity:

• trace (only on debug builds)
• debug (only on debug builds)
• info (default)
• warn
• error

For example:

RUST_LOG=debug hinoirisetr

Dependencies

• Rust and Cargo: Required for building the project.
• Backends: Depending on your configuration, you may need one or more of the following:
  • ddcutil
  • gammastep
  • hyprctl (with hyprsunset for Hyprland)
  • redshift
  • xsct
• libnotify: Optional, for desktop notifications.

Ensure that the required backends are installed and available in your PATH.

Contributing

Contributions are welcome! Please submit issues or pull requests to the repository at forgejo.

License

This project is licensed under the MIT License. See the LICENSE file for details.