sessiond
GitHub Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

sessiond.conf.5

NAME

sessiond.conf - sessiond configuration file format

SYNOPSIS

XDG_CONFIG_HOME/sessiond/sessiond.conf or HOME/.config/sessiond/sessiond.conf

DESCRIPTION

This file configures the X session manager sessiond(1). Its syntax is toml v0.5.0. See: https://github.com/toml-lang/toml/tree/v0.5.0.

OPTIONS

[Idle]

  • Inputs=

    A list (of the format [“item”, “item”]) of input event types used to determine activity. Values are “motion”, “button-press”, “button-release”, “key-press”, “key-release”.

  • IdleSec=

    Seconds the session must be inactive before considered idle.

[Lock]

  • OnIdle=

    If “true”, lock the session when it becomes idle.

  • OnSleep=

    If “true”, lock the session when systemd-logind(8) sends the “PrepareForSleep” signal.

  • StandbySec=

    DPMS standby timeout in seconds to use while session is locked. Must occur before or simultaneously with Suspend timeout.

  • SuspendSec=

    DPMS suspend timeout in seconds to use while session is locked. Must occur before or simultaneously with Off timeout.

  • OffSec=

    DPMS off timeout in seconds to use while session is locked.

  • MuteAudio=

    If “true”, mute the default audio sink while the session is locked. The mute state will be restored when unlocked.

[DPMS]

  • Enable=

    If “true”, apply DPMS settings, including those in the “[Lock]” section.

  • StandbySec=

    DPMS standby timeout in seconds. Must occur before or simultaneously with Suspend timeout.

  • SuspendSec=

    DPMS suspend timeout in seconds. Must occur before or simultaneously with Off timeout.

  • OffSec=

    DPMS off timeout in seconds.

[[Backlight]]

Backlights are configured as an array of tables, using the section “[[Backlight]]”. The options will be applied to backlights with the same path.

  • Path=

    Path to the backlight device via sys mount point. Should be of the format: “/sys/class/subsystem/name”.

  • DimSec=

    Seconds the session must be inactive before the backlight is dimmed.

  • DimValue=

    Value of the backlight brightness when dimming.

  • DimPercent=

    Percentage to lower backlight brightness when dimming.

[[Hook]]

Hooks are configured as an array of tables, using the section “[[Hook]]”. See sessiond-hooks(5) for a description of options.

SEE ALSO

sessiond(1), systemd-logind.service(8), sessiond-hooks(5)