NAME¶
UNL0KR - configuration file
DESCRIPTION¶
UNL0KR expects a configuration file with options in the following
format, with one option/value pair per line:
[section]
<option>=<value>
The default configuration file is at /etc/unl0kr.conf, UNL0KR will
use this configuration file if present along with overrides placed in
/etc/unl0kr.conf.d/ and those specified with the -C option. All config files
will be merged in the following order:
•/etc/unl0kr.conf
•/etc/unl0kr.conf.d/ (alphabetically)
•Override files (in supplied order)
OPTIONS¶
General¶
animations = <true|false>
Enable or disable animations. Useful for slower devices.
Default: false.
backend = <fbdev|drm>
The rendering backend to use. Default: fbdev.
timeout = <value>
The time in seconds before unl0kr will consider the entry
a failure and shutdown. Setting timeout to 0 disables this feature. Default:
0.
Keyboard¶
autohide = <true|false>
Whether to automatically hide the keyboard when a
hardware keyboard is detected on launch. Default: true.
layout = <us|de|fr|...>
The default layout to use. Can be changed from the UI at
runtime. The available options are defined by the available keyboards at build
time. Default: us.
popovers = <true|false>
Enable or disable key press popovers showing the selected
key. default: true.
Textarea¶
obscured = <true|false>
Whether the password in the text entry box can be read.
Selectable in the UI at runtime. Default: true.
bullet = <value>
The character that will be used to obscure the password.
Default: bullet.
Theme¶
default =
<breezy-light|breezy-dark|pmos-light|pmos-dark>
Selects the default theme on boot. Can be changed at
runtime to the alternative theme. Default: breezy-dark.
alternative =
<breezy-light|breezy-dark|pmos-light|pmos-dark>
Selects the alternative theme which the user can then
choose on boot. Default: breezy-light.
keyboard = <true|false>
Enable or disable the use of hardware keyboards. Default:
true
pointer = <true|false>
Enable or disable the use of a hardware mouse or other
pointing device. Default: true.
touchscreen = <true|false>
Enable or disable the use of the touchscreen. Default:
true.
Quirks¶
fbdev_force_refresh = <true|false>
If true and using the framebuffer backend, this triggers
a display refresh after every draw operation. This has a negative performance
impact. Default: false.
terminal_prevent_graphics_mode = <true|false>
If true, this avoids setting the terminal into graphics
mode. This will show the terminal command prompt. Default: false.
terminal_allow_keyboard_input = <true|false>
If true, this avoids turning off terminal keyboard input.
This will show your password on the terminal. Default: false.
AUTHORS¶
Undef <debian@undef.tools> Johannes Marbach
<n0-0ne@mailbox.org>
