Minecraft spiele ich mit dem Controller vom Sofa aus. Nur zum Tippen musste bisher die Tastatur her. gamepad-osk von 0x90shell ist eine Bildschirmtastatur, die auf eine Tastenkombination hin erscheint und komplett mit dem Controller bedient wird. Ich habe sie für mich angepasst, mein Fork ist öffentlich.

Update 15.11.2026: Einstellungsfenster, Mausmodus, Transparenz, eigene Belegung, Buttons auf den Tasten, Controller-Test – zum Update.

Helle Bildschirmtastatur mit weißen, abgerundeten Tasten in deutscher QWERTZ-Belegung mit Umlauten, die Taste h blau markiert, darunter eine Leiste mit Controller-Tasten und ihrer Funktion: B Tippen, Y Löschen, X Leerzeichen, ZR Enter, ZL Groß
Mein Fork: hell, deutsch, mit Belegung.

Das Original

gamepad-osk macht das Schwierige richtig gut: Es liest den Controller direkt aus, tippt über eine virtuelle Tastatur und läuft unter X11 und Wayland, ganz ohne Steam. Der rechte Stick steuert die Maus. Solange die Tastatur versteckt ist, achtet sie nur auf die Tastenkombination, das Spiel behält den Controller. Dazu kommen 60 Farbschemata. Danke an 0x90shell für die Arbeit und die MIT-Lizenz, die einen Fork erlaubt.

Was mein Fork ändert

  • Helles Design als Standard, angelehnt an die iPhone-Tastatur. Das Original-Design und alle 60 Schemata bleiben wählbar.
  • Belegung unter den Tasten: B Tippen · ZR Enter · ZL Groß …, mit der Beschriftung des eigenen Controllers, auf Deutsch oder Englisch.
  • Controller-Profile für Xbox, PlayStation, Nintendo/8BitDo und allgemeine Controller. Das Profil wird automatisch erkannt, sonst reicht eine Zeile in der Einstellungsdatei.
  • 8BitDo über Bluetooth: Rechter Stick und LT halten für Großbuchstaben funktionieren jetzt. Vorher hielt das Programm den Stick für die Trigger.
  • Deutsches Layout mit ä ö ü ß und AltGr-Zeichen wie @ und €. Es wird automatisch gewählt, wenn der Desktop deutsch eingestellt ist.
  • Schriften über fontconfig. Unter Fedora brach das Original mit no suitable font found ab.
  • Installation in einer Zeile, inklusive Autostart.
Dunkle Variante mit aktivierter Umschalttaste, alle Buchstaben groß, darunter die Belegung mit farbigen PlayStation-Symbolen Kreuz, Quadrat, Dreieck und Kreis
Dunkel, mit PlayStation-Symbolen.

Installieren

curl -fsSL https://raw.githubusercontent.com/TechnikWeber/gamepad-osk/main/install.sh | bash

Das Skript legt alles im eigenen Benutzerordner ab und richtet den Autostart ein. Nach dem Passwort fragt es nur, wenn SDL3 fehlt oder das System keinen Zugriff auf die virtuelle Tastatur gibt. Danach am Controller Guide + Select drücken, beim 8BitDo Home + −.

Zusammen mit Minecraft

Mein Minecraft startet nach dem Login automatisch und wird über die Mod Controlify gesteuert. gamepad-osk läuft daneben unsichtbar und greift erst ein, wenn ich es einblende. Solange die Tastatur zu sehen ist, gehört der Controller ihr, danach wieder dem Spiel.

Das ursprüngliche Matrix-Design: eckige, dunkle Tasten mit grüner Schrift, darunter ebenfalls die Belegungsleiste
Das Original-Design gibt es weiterhin.

Mein Fork auf GitHub · Das Original von 0x90shell

Update vom 15.11.2026

Einstellungsfenster (ab 2.3.0). Im Startmenü unter gamepad-osk Einstellungen oder über die Taste Einstell. auf der Tastatur selbst. Bedienbar mit Controller, Maus oder Tastatur, oben eine Vorschau.

Einstellungsfenster mit den Reitern Allgemein und Belegung: oben die Vorschau der hellen Tastatur mit Belegungsleiste, darunter zwei Spalten mit Beim Anmelden starten, Design, Tastaturlayout, Controller-Beschriftung, Ein-/Ausblenden mit, Nur Maus mit, Maus, Mausgeschwindigkeit, Feinsteuerung Maus, Feinsteuerung Scrollen, Transparenz, Belegung anzeigen, Position und Größe, unten Schließen und Speichern
Alles an einem Ort, mit Vorschau.
  • Beim Anmelden starten: ein Schalter statt Konsolenbefehl.
  • A und B tauschen für Controller, bei denen es sich falsch herum anfühlt.
  • Eigenes 8BitDo-Profil: Beim Ultimate 2C liegt A unten und B rechts, nicht wie oben im ersten Bild.
  • Speichern startet die Tastatur neu, Änderungen gelten sofort.

Mausmodus (ab 2.4.0). Mit Home + + (allgemein Guide + Start) bleibt die Tastatur weg, unten in der Mitte sitzt nur ein kleines Maus-Symbol. Der Stick bewegt den Zeiger, A klickt, LB ist der Rechtsklick, der andere Stick scrollt, B beendet.

Kleine abgerundete Leiste am unteren Bildschirmrand mit blauem Maus-Symbol und A Klick, LB Rechtsklick, L-Stick Scrollen, B Beenden
Statt der Tastatur nur ein kleines Symbol.
  • Transparenz per Schieberegler, jetzt auch unter Wayland. Klicks gehen durch die Tastatur hindurch auf das Fenster dahinter.
  • Belegung frei wählbar: Auf der zweiten Seite der Einstellungen kommt jede Funktion auf die Taste, die man möchte.
  • Mausgeschwindigkeit startet jetzt bei 20 und ist im Mausmodus genauso schnell wie bei offener Tastatur (ab 2.5.0, vorher war sie dort viel zu schnell).
  • Buttons auf den Tasten (ab 2.5.0): Enter, Leertaste, Löschen, Shift und Caps zeigen in der Ecke, welcher Controller-Knopf sie auslöst. Abschaltbar in den Einstellungen.
Helle deutsche Tastatur, kleine Abzeichen in den Tastenecken: X auf der Löschtaste, RT auf Enter, LT auf beiden Shift-Tasten, RS auf Caps und Y auf der Leertaste
Kleine Abzeichen zeigen den zuständigen Knopf.

Controller-Test (ab 2.6.0). Die Seite Test in den Einstellungen zeigt einen Controller, auf dem jeder gedrückte Knopf aufleuchtet, daneben, was er in gamepad-osk tut. So sieht man sofort, ob A und B vertauscht sind – oder dass das 8BitDo-Logo Home heißt.

Einstellungsseite Test: unten ein schematischer Controller mit LT, LB, RT, RB, Minus, Home, Plus, Steuerkreuz, X Y A B und zwei Stick-Kreisen, rechts daneben Zuletzt gedrückt
Drücken, aufleuchten sehen, fertig.

Ubuntu 24.04, Linux Mint 22, Debian 12 und Bazzite: Dort fehlt SDL3 als Paket bzw. ist das System schreibgeschützt. Der Installer nimmt dann automatisch eine Fassung, die SDL3 gleich mitbringt – ohne Root-Rechte und ohne Neustart.

Aktualisieren geht mit demselben Befehl wie die Installation.