LIDM-CONFIG(5) File Formats Manual LIDM-CONFIG(5)

lidm-configLiDM display and login behavior configuration

/etc/lidm.ini is a table-oriented configuration file. A table begins with [name]; assignments below it have the form key = value. Blank lines, comments beginning with #, and whitespace around keys and the equals sign are accepted.

Strings use double quotes and accept backslash escapes and \xHH byte escapes. Booleans are unquoted true or false. Numbers are unquoted decimal integers. Keys in the functions table are unquoted keyboard names such as F1. Repeating source or user_source appends another string to that list.

Every value in the colors table is a quoted ANSI SGR parameter string without the CSI prefix or final m.

bg, fg, err
Background, ordinary foreground, and error styles.
s_wayland, s_xorg, s_shell
Session-type styles.
e_hostname, e_date, e_box, e_header
Hostname, date, border, and heading styles.
e_user, e_passwd, e_badpasswd, e_key
Username, password, failed-password, and key-label styles.
MOUSE's stock file uses ordinary ANSI white on black for every element.

The quoted hb and vb values draw horizontal and vertical borders. ctl, ctr, cbl, and cbr draw the four corners. MOUSE uses ASCII borders because the wscons login console is eight-bit.

The poweroff, reboot, fido, and refresh keys bind login-screen actions. MOUSE omits fido, leaving that function disabled.

f_poweroff, f_reboot, f_fido, f_refresh
Labels for function keys.
e_user, e_passwd
Field labels.
s_wayland, s_xorg, s_shell
Session headings.
opts_pre, opts_post
Text placed before and after an option selector.
ellipsis
Overflow marker.

include_defshell
Boolean; include the authenticated account's shell in the session list.
source
Repeatable absolute path to an environment file read before login.
user_source
Repeatable path relative to the authenticated user's home directory.
timefmt
Quoted strftime(3) format for the displayed clock.
refresh_rate
Refresh interval in milliseconds.
bypass_shell_login
Boolean; execute a shell session directly instead of passing it through a login shell.

Environment files named by source and user_source contain simple NAME=VALUE lines, comments, and blank lines. They do not support quoting or escape processing.

/etc/lidm.ini
MOUSE configuration and visual defaults.

Syntax errors stop LiDM before the login screen appears. The service writes details to /var/log/lidm.log.

lidm(1), strftime(3)

MOUSE August 17, 2026 LIDM-CONFIG(5)