---
name: "unl0kr"
section: "1"
platform: "linux"
package: "unl0kr"
version: "2.0.3+dfsg-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/unl0kr"
---

# unl0kr(1)

LVGL based initramfs disk unlocker

## NAME

UNL0KR - LVGL based initramfs disk unlocker

## SYNOPSIS

unl0kr \[OPTION\]

## 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.

## 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.

## 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 -

## SEE ALSO

[**unl0kr.conf**(5)](/unl0kr.conf/5.md)

## AUTHORS

**Undef** \<debian@undef.tools\>