unl0kr(5)

💖 UNL0KR 💖

okay bestie, so this is the manual page for unl0kr(5) — the File Formats Manual girlies — and it's literally all about the UNL0KR configuration file ✨ buckle up 🎀

---

✨ NAME ✨

UNL0KR — the configuration file, and yes she ate 💅

---

🌸 DESCRIPTION 🌸

ngl, UNL0KR is so chill about this. She expects a config file where every option sits on its own little line, one option/value pair per line, in exactly this format:

[section]
<option>=<value>

that's it. that's the whole vibe. 🦋

so here's the tea on launch ☕: UNL0KR goes hunting for config files in a bunch of locations, and then — this is the important part — she successively merges all of them together into one single configuration. like a group chat merging into one giant huddle 🫂

files are searched for, and if found, merged in this exact order:

• /usr/share/unl0kr/unl0kr.conf
• /usr/share/unl0kr/unl0kr.conf.d/ (alphabetically, bestie — she's organized)
• /etc/unl0kr.conf
• /etc/unl0kr.conf.d/ (alphabetically again 💅)
• Override files (in supplied order — your order, main character energy 👑)

lowkey important: the merge order matters. later files win. iykyk.

---

👑 OPTIONS 👑

💫 General

• animations = <true|false> — turn animations on or off. super useful for slower devices, no cap. Default: false.
• backend = <fbdev|drm|sdl> — which rendering backend you wanna use. Default: the first compiled backend from that list above, so it depends on how she was built 🧚
• timeout = <value> — how many seconds before unl0kr decides the entry is a failure and shuts down 😭 set timeout to 0 to disable this whole feature. Default: 0.

⌨️ Keyboard

• autohide = <true|false> — whether to automatically hide the keyboard when a hardware keyboard gets detected on launch. Default: true.
• layout = <us|de|fr|...> — the default layout to use. you can change it from the UI at runtime, so don't stress 💅 the available options are defined by the available keyboards at build time. Default: us.
• popovers = <true|false> — enable or disable key press popovers that show you which key you selected. Default: true.
• haptic_feedback = <true|false> — enable or disable vibrations when pressing keys 🫨 Default: true.

🎀 Textarea

• obscured = <true|false> — whether the password in the text entry box can actually be read 👀 selectable in the UI at runtime. Default: true.
• bullet = <value> — the character used to obscure the password. Default: bullet.

🌈 Theme

• default = <adwaita-light|adwaita-dark|breezy-light|breezy-dark|nord-light|nord-dark|pmos-light|pmos-dark> — picks 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> — picks the alternative theme, which the user can then choose on boot. Default: breezy-light.

🖱️ Input

• 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 you're using the framebuffer backend, this triggers a display refresh after every single draw operation. heads up: 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, bestie, fr fr. Default: false.

---

🔥 SEE ALSO 🔥

• unl0kr(1)

---

💜 AUTHORS 💜

Undef <debian@undef.tools> Johannes Marbach <n0-0ne@mailbox.org>

---

and that's the whole page, slay 💅✨ this little legend is filed under unl0kr(5) from the unl0kr source, dated 2026-06-20 — go forth and configure, icon, you've got this 🎀🦋💖