### Launch Hypridle in Hyprland

Source: https://github.com/hyprwm/hypridle/blob/main/README.md

Example of how to launch hypridle automatically when Hyprland starts, by adding it to your hyprland.conf.

```hyprlang
exec-once = hypridle
```

--------------------------------

### Enable Hypridle with systemd

Source: https://github.com/hyprwm/hypridle/blob/main/README.md

Instructions to enable and start the hypridle service using systemd for user sessions.

```sh
systemctl --user enable --now hypridle.service
```

--------------------------------

### Configure Hypridle Settings

Source: https://github.com/hyprwm/hypridle/blob/main/README.md

Example configuration for hypridle.conf, showing general settings like lock commands and listener configurations for timeouts and resume events.

```ini
general {
    lock_cmd = notify-send "lock!"          # dbus/sysd lock command (loginctl lock-session)
    unlock_cmd = notify-send "unlock!"      # same as above, but unlock
    before_sleep_cmd = notify-send "Zzz"    # command ran before sleep
    after_sleep_cmd = notify-send "Awake!"  # command ran after sleep
    ignore_dbus_inhibit = false             # whether to ignore dbus-sent idle-inhibit requests (used by e.g. firefox or steam)
    ignore_systemd_inhibit = false          # whether to ignore systemd-inhibit --what=idle inhibitors
}

listener {
    timeout = 500                            # in seconds
    on-timeout = notify-send "You are idle!" # command to run when timeout has passed
    on-resume = notify-send "Welcome back!"  # command to run when activity is detected after timeout has fired.
}
```

--------------------------------

### Install Hypridle

Source: https://github.com/hyprwm/hypridle/blob/main/README.md

Command to install hypridle after building it with CMake. This typically requires root privileges.

```sh
sudo cmake --install build
```

--------------------------------

### Verify installed hypridle version

Source: https://context7.com/hyprwm/hypridle/llms.txt

Check the installed version of hypridle after building and installing from source.

```sh
hypridle --version
```

--------------------------------

### Build hypridle from source

Source: https://context7.com/hyprwm/hypridle/llms.txt

Steps to configure, build, and install hypridle from source using CMake. Requires CMake >= 3.19 and C++23.

```sh
sudo pacman -S wayland wayland-protocols hyprland-protocols hyprlang hyprutils sdbus-cpp hyprwayland-scanner
```

```sh
cmake --no-warn-unused-cli \
      -DCMAKE_BUILD_TYPE=Release \
      -DCMAKE_INSTALL_PREFIX=/usr \
      -S . -B ./build
```

```sh
cmake --build ./build --config Release --target all \
      -j$(nproc 2>/dev/null || getconf NPROCESSORS_CONF)
```

```sh
sudo cmake --install build
```

--------------------------------

### Configure hypridle in Hyprland conf

Source: https://context7.com/hyprwm/hypridle/llms.txt

Launch hypridle directly from Hyprland's configuration file using exec-once. This is suitable for setups not using systemd session management.

```hyprlang
exec-once = hypridle
```

```hyprlang
exec-once = hypridle -c ~/.config/hypr/hypridle.conf
```

--------------------------------

### Hypridle Configuration File Example

Source: https://context7.com/hyprwm/hypridle/llms.txt

Defines general settings for session-level hooks, including lock/unlock commands, sleep/wake transitions, and idle inhibition behavior. Supports custom paths and sourcing multiple config files.

```ini
# ~/.config/hypr/hypridle.conf

general {
    # Fired when loginctl sends a Lock signal (e.g. loginctl lock-session)
    lock_cmd = pidof hyprlock || hyprlock       # avoid duplicate instances

    # Fired when loginctl sends an Unlock signal
    unlock_cmd = notify-send "Session unlocked"

    # Fired on Wayland-protocol lock event (requires hyprland-lock-notify-v1)
    on_lock_cmd = notify-send "Screen locked"
    on_unlock_cmd = notify-send "Screen unlocked"

    # Fired just before the system suspends (logind PrepareForSleep)
    before_sleep_cmd = loginctl lock-session

    # Fired after the system resumes from sleep
    after_sleep_cmd = hyprctl dispatch dpms on

    # Ignore idle-inhibit requests sent over D-Bus (e.g. from Firefox/Steam)
    ignore_dbus_inhibit = false

    # Ignore systemd-inhibit --what=idle inhibitors
    ignore_systemd_inhibit = false

    # Ignore Wayland idle-inhibit protocol
    ignore_wayland_inhibit = false

    # Sleep inhibition:
    #   0 = disabled
    #   1 = always hold delay lock until before_sleep_cmd completes
    #   2 = auto (default) – wait for hyprlock if used in before_sleep_cmd
    #   3 = wait until Wayland session is locked (requires lock-notify protocol)
    inhibit_sleep = 2
}

# Split config via source directive (glob supported)
source = ~/.config/hypr/idle-extra/*.conf

```

--------------------------------

### Build Hypridle with CMake

Source: https://github.com/hyprwm/hypridle/blob/main/README.md

Commands to build hypridle using CMake. Ensure you have the necessary dependencies installed before building.

```sh
cmake --no-warn-unused-cli -DCMAKE_BUILD_TYPE:STRING=Release -DCMAKE_INSTALL_PREFIX:PATH=/usr -S . -B ./build
cmake --build ./build --config Release --target all -j`nproc 2>/dev/null || getconf NPROCESSORS_CONF`
```

--------------------------------

### Disable hypridle systemd service autostart

Source: https://context7.com/hyprwm/hypridle/llms.txt

Disable the user-level hypridle systemd service from starting automatically on login.

```sh
systemctl --user disable hypridle.service
```

--------------------------------

### Hypridle Listener Block Examples

Source: https://context7.com/hyprwm/hypridle/llms.txt

Defines timed idle rules with optional commands for when the system becomes idle or resumes activity. Listeners can fire even while inhibitors are active if ignore_inhibit is true.

```ini
# Dim display after 2.5 min of inactivity
listener {
    timeout = 150
    on-timeout = brightnessctl -s set 10   # save current brightness, set to 10%
    on-resume  = brightnessctl -r          # restore saved brightness
}

# Turn off keyboard backlight at the same time
listener {
    timeout = 150
    on-timeout = brightnessctl -sd rgb:kbd_backlight set 0
    on-resume  = brightnessctl -rd rgb:kbd_backlight
}

# Lock the session after 5 min
listener {
    timeout = 300
    on-timeout = loginctl lock-session
    # no on-resume needed
}

# Turn off display 30 s after lock (5.5 min total)
listener {
    timeout = 330
    on-timeout = hyprctl dispatch dpms off
    on-resume  = hyprctl dispatch dpms on
}

# Suspend after 30 min of inactivity, bypassing all inhibitors
listener {
    timeout      = 1800
    on-timeout   = systemctl suspend
    ignore_inhibit = true                  # fires even if e.g. a video is playing
}

```

--------------------------------

### Hypridle CLI: Version and Verbosity Flags

Source: https://context7.com/hyprwm/hypridle/llms.txt

Control hypridle's output and logging verbosity. Use --version to check the installed version, --verbose for detailed logs, and --quiet to suppress non-critical output.

```sh
# Print version and exit
hypridle --version
# Output: hypridle v0.1.7

# Launch with verbose logging (useful for debugging listener timing)
hypridle --verbose

# Launch silently (background daemon use-case)
hypridle --quiet

```

--------------------------------

### Run hypridle with a custom config

Source: https://context7.com/hyprwm/hypridle/llms.txt

Specify a custom configuration file path using the --config option.

```sh
hypridle --config /etc/hypr/hypridle-shared.conf
```

--------------------------------

### Display hypridle help message

Source: https://context7.com/hyprwm/hypridle/llms.txt

Show the help message to see available options and their descriptions.

```sh
hypridle --help
```

--------------------------------

### View live logs for hypridle systemd service

Source: https://context7.com/hyprwm/hypridle/llms.txt

Follow the live logs of the user-level hypridle systemd service using journalctl.

```sh
journalctl --user -u hypridle.service -f
```

--------------------------------

### Include Additional Config Files with Source Directive

Source: https://context7.com/hyprwm/hypridle/llms.txt

Use the `source` directive to include additional configuration files, supporting glob patterns for dynamic loading. Paths support `~` expansion and relative paths.

```ini
# Main config: ~/.config/hypr/hypridle.conf
general {
    lock_cmd         = hyprlock
    before_sleep_cmd = loginctl lock-session
    after_sleep_cmd  = hyprctl dispatch dpms on
    inhibit_sleep    = 2
}

# Load all .conf files from a subdirectory
source = ~/.config/hypr/idle.d/*.conf
```

```ini
# ~/.config/hypr/idle.d/display.conf
listener {
    timeout    = 300
    on-timeout = hyprctl dispatch dpms off
    on-resume  = hyprctl dispatch dpms on
}
```

```ini
# ~/.config/hypr/idle.d/lock.conf
listener {
    timeout    = 270
    on-timeout = loginctl lock-session
}
```

--------------------------------

### Verify logind Delay Inhibitor

Source: https://context7.com/hyprwm/hypridle/llms.txt

Verify that the delay inhibitor is held by hypridle while it is running. This command lists active systemd inhibitors.

```sh
# Verify the delay inhibitor is held while hypridle is running
systemd-inhibit --list
# WHO     UID  USER    PID   COMM       WHAT  WHY                                          MODE
# hypridle 1000 alice  12345 hypridle  sleep  Hypridle wants to delay sleep ...            delay
```

--------------------------------

### Configure Sleep Inhibition with logind

Source: https://context7.com/hyprwm/hypridle/llms.txt

Configure hypridle to delay system suspend until pre-sleep commands complete. Use `inhibit_sleep = 2` for auto-detection of hyprlock or `inhibit_sleep = 3` to wait for Wayland session lock state.

```ini
general {
    before_sleep_cmd = loginctl lock-session
    after_sleep_cmd  = hyprctl dispatch dpms on
    inhibit_sleep    = 2   # auto-detect hyprlock in before_sleep_cmd
}

# Explicit "wait for lock" mode (requires hyprland-lock-notify-v1):
# inhibit_sleep = 3
# before_sleep_cmd = hyprlock  # lock screen directly
```

--------------------------------

### Hypridle Command-Line Flags

Source: https://github.com/hyprwm/hypridle/blob/main/README.md

Common command-line flags for hypridle, including options for specifying a configuration path, quiet mode, and verbose output.

```sh
-c <config_path>, --config <config_path>: specify a config path, by default
                                          set to ${XDG_CONFIG_HOME}/hypr/hypridle.conf
-q, --quiet
-v, --verbose
```

--------------------------------

### Check hypridle systemd service status

Source: https://context7.com/hyprwm/hypridle/llms.txt

View the status of the user-level hypridle systemd service.

```sh
systemctl --user status hypridle.service
```

--------------------------------

### Restart hypridle systemd service

Source: https://context7.com/hyprwm/hypridle/llms.txt

Restart the user-level hypridle systemd service, typically after configuration changes.

```sh
systemctl --user restart hypridle.service
```

--------------------------------

### Manually inhibit idle using D-Bus

Source: https://context7.com/hyprwm/hypridle/llms.txt

Use dbus-send to interact with the org.freedesktop.ScreenSaver D-Bus interface to inhibit idle. This is useful for scripts or applications that need to temporarily prevent idle actions.

```sh
COOKIE=$(dbus-send --session --print-reply --dest=org.freedesktop.ScreenSaver \
    /org/freedesktop/ScreenSaver \
    org.freedesktop.ScreenSaver.Inhibit \
    string:"my-presentation-script" \
    string:"Presentation in progress" \
    | awk '/uint32/ { print $2 }')

echo "Inhibit cookie: $COOKIE"
```

```sh
dbus-send --session --dest=org.freedesktop.ScreenSaver \
    /org/freedesktop/ScreenSaver \
    org.freedesktop.ScreenSaver.UnInhibit \
    uint32:"$COOKIE"
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.