UNL0KR - LVGL based initramfs disk unlocker

Authors

Undef <debian@undef.tools>

unl0kr                                             2025-01-06                                          unl0kr(1)

Description

       UNL0KR  is  a  disk unlocker for the initramfs based on LVGL. By using LVGL and rendering directly to the
       framebuffer it can work without relying on GPU hardware acceleration. This makes for much more  managable
       initramfs sizes.

       Unl0kr  utilises the CRYPTTAB_TRIED variable. Upon completion, the entered password is printed to STDOUT.
       All other output happens on STDERR.

Examples

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

Name

       UNL0KR - LVGL based initramfs disk unlocker

Options

Optional-C,--config-override
           Path to a config override file. Can be supplied multiple  times.  Config  files  are  merged  in  the
           following order:
               •   /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.
       -d--dpi=N
           Override the display's DPI value.
       -h,--help
           Print this message and exit.
       -v,--verbose
           Enable more detailed logging output on STDERR.
       -V,--version
           Print the unl0kr version and exit.