unl0kr(1)

📦
version 3.5.1 · 7 versions
, in ubuntu stonking

💖 UNL0KR — bestie's guide to the LVGL initramfs disk unlocker 💖

okay so real talk, this is unl0kr(1), a General Commands Manual page, and it's about to become your whole personality. no cap.

✨ NAME ✨

UNL0KR — an LVGL based initramfs disk unlocker 🎀

🌸 SYNOPSIS 🌸

unl0kr [OPTION]

💅 DESCRIPTION 💅

so UNL0KR is literally a disk unlocker for the initramfs, built on LVGL. and here's the slay part: because it uses LVGL and renders directly to the framebuffer, it can just… do its thing without leaning on GPU hardware acceleration. no GPU? no problem, bestie. that means your initramfs sizes stay much more managable. it's giving minimal, it's giving efficient, it's giving main character energy on a tiny little initramfs. 🦋

Unl0kr utilises the CRYPTTAB_TRIED variable. Upon completion, the entered password is printed to STDOUT. All other output happens on STDERR. yes queen, password out the front door, everything else goes out the side door — keep that in mind. 🔥

👑 OPTIONS 👑

🍓 Optional

  • -m, --message — a message that will be displayed to a user. 💬
  • -C, --config-override — path to a config override file. can be supplied multiple times, bc we're extra like that. config files are merged in the following order:
    • /usr/share/unl0kr/unl0kr.conf
    • /usr/share/unl0kr/unl0kr.conf.d/* (alphabetically)
    • /etc/unl0kr.conf
    • /etc/unl0kr.conf.d/* (alphabetically)
    • Override files (in supplied order)
  • -g, --geometry=NxM[@X,Y] — force a display size of N horizontal times M vertical pixels, offset horizontally by X pixels and vertically by Y pixels. so NxM is the size and @X,Y is where you're placing it, got it? 📐
  • -d --dpi=N — override the display's DPI value.
  • -h, --help — print this message and exit. the classic "bestie what do i do" button. 🙈
  • -n — do not append a newline character to a password. no trailing newline, she said.
  • -v, --verbose — enable more detailed logging output on STDERR. turn it up, we love details. ✨
  • -V, --version — print the unl0kr version and exit.

🌈 EXAMPLES 🌈

Decrypt /dev/sda1 to name "root":

CRYPTTAB_SOURCE="/dev/sda1" CRYPTTAB_TRIED="0" unl0kr | cryptsetup
--perf-no_read_workqueue --perf-no_write_workqueue open "/dev/sda1"
root -

iconic. literally the whole pipeline in two lines. periodt. 💜

🔍 SEE ALSO 🔍

🫶 AUTHORS 🫶

Undef <debian@undef.tools>

lowkey obsessed with this lil password box ngl. go forth and unlock your disks, bestie. 💖🔐

kisses, and also: this was unl0kr, version/manual tagged 2026-06-20, from unl0kr(1) — see you in the initramfs, mwah 💅✨

📦 where this page comes from