Moxidle

Feature-rich Wayland idle daemon.

Features

• Implements the ext-idle-notify-v1 Wayland protocol
• Supports loginctl commands (lock, unlock, before-sleep)
• Handles DBus idle-inhibit (used by applications like Firefox and Steam)
• Supports audio-based idle inhibition
• Allows for configurable conditional listeners
• Extends beyond default org.freedesktop.SessionManager protocol by implementing additional features available in kscreenlocker

Configuration

Moxidle's configuration is written in Nix and is located at $XDG_CONFIG_HOME/mox/moxidle.nix or $XDG_CONFIG_HOME/mox/moxidle/default.nix.

Example Configuration

{
  general = {
    # Command executed when org.freedesktop.login1.Session Lock signal is emitted
    # This signal is triggered by commands like 'loginctl lock-sessions'
    lock_cmd = "pidof hyprlock || hyprlock";

    # Command executed when org.freedesktop.login1.Session Unlock signal is emitted  
    # This signal is triggered by commands like 'loginctl unlock-sessions'
    unlock_cmd = "pkill -USR1 hyprlock";

    before_sleep_cmd = "notify-send 'Going to sleep'"; # Command executed before sleep
    after_sleep_cmd = "notify-send 'Awake!'";          # Command executed after waking up
    ignore_dbus_inhibit = false;                       # Ignore DBus idle-inhibit requests
    ignore_systemd_inhibit = false;                    # Ignore systemd idle inhibitors
    ignore_audio_inhibit = false;                      # Ignore audio activity inhibition
  };

  listeners = [
    {
      conditions = [ "on_battery" { battery_below = 20; } ]; # Conditions needed to be fulfilled for timeout to launch
      timeout = 300;                                         # Idle timeout in seconds
      on_timeout = "systemctl suspend";                      # Command executed on timeout
      on_resume = "notify-send 'Welcome back!'";             # Command executed on user activity
    }
    {
      conditions = [ "on_ac" ];
      timeout = 300;
      on_timeout = "pidof hyprlock || hyprlock";
      on_resume = "notify-send 'Welcome back!'";
    }
  ];
}

Dependencies

• Rust
• dbus
• wayland
• upower (Optional, required if battery-related conditions are set)
• libpulseaudio (Optional, required if audio features are enabled)

Building

To build with default features:

cargo build --release

Custom Build

To disable libpulseaudio dependency, run:

cargo build --no-default-features

Feature Flags

• audio – Enables audio integration

Installation

cargo install --path .

Usage

To start Moxidle manually:

moxidle

For automatic startup, you can add it to your compositor's config or use systemd:

systemctl --user enable --now moxidle.service

You can temporarily prevent idle actions using systemd-inhibit:

systemd-inhibit \
  --who="me" \
  --what=idle \
  --why="Prevent my system from sleeping" \

Command-line Flags

-c <config_path>, --config <config_path>  Specify a custom config path (default: $XDG_CONFIG_HOME/moxidle.nix)
-q, --quiet                               Suppress output
-v, --verbose                             Enable verbose logging