OSK-SDL - Disk encryption initramfs on screen keyboard

Undef <debian@undef.tools>

osk-sdl                                            2025-02-23                                         osk-sdl(1)

       OSK-SDL is a lightweight on screen keyboard used to unlock encrypted root partitions on mobile devices.

Decrypt/dev/sda1toname"root"
           osk-sdl -d /dev/sda1 -n root -c /etc/osk.conf

       OSK-SDL - Disk encryption initramfs on screen keyboard

Mandatory-t,--testmode
           Run in test mode, do not attempt to initialise the whole screen.

       -d<path>
           Decrypt this disk. This argument is mandatory unless -t is used.

       -n<name>
           Name of the decrypted disk.

   Optional-h
           Show help options

       -c<path>
           Locaton of the osk-sdl config file. Defaults to "/etc/osk.conf".

       -o<path>
           Locaton of the osk-sdl config override file. Does not cause a failure if it couldn't be loaded.

       -v,--verbose
           Enable verbose output

       -k,--keyscript
           Enable  keyscript  mode.  Password  will  be  output  to  STDOUT for use with another program such as
           cryptsetup-initramfs.

       -G,--no-gles
           Do not use OpenGL ES driver unless it is the default driver. This is the default behavior when  using
           DirectFB.

       -x,--no-keyboard
           Do  not  display  the  keyboard,  only  the input box. This is only useful on devices with a physical
           keyboard that want to use osk-sdl as a prettier prompt than "cryptsetup open"

       -s,--show-keyboard
           Show the osk by default, even if a physical keyboard is connected.

osk.conf(5)

       osk-sdl -d DISK -n NAME [OPTION]