---
name: "osk-sdl"
section: "1"
platform: "linux"
package: "osk-sdl"
version: "0.67.1-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/osk-sdl"
---

# osk-sdl(1)

Disk encryption initramfs on screen keyboard

## NAME

OSK-SDL - Disk encryption initramfs on screen keyboard

## SYNOPSIS

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

## DESCRIPTION

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

## OPTIONS

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

## EXAMPLES

**Decrypt /dev/sda1 to name "root"**

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

## SEE ALSO

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

## AUTHORS

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