Wallaby-VK 
Virtuelles On-Screen-Keyboard mit deutschem Layout für Linux Kubuntu(u. andere) / Wayland
v2.3.4 · Juli 2026
↓ Download
Wallaby-VK-2.3.4-x86_64.AppImage.zip
AppImage (x86_64)
+ ReadMe · menügeführte 'Installation' · inkl
Updatemechanismus · Linux / Wayland
MD5: 3f681980a936f665baf0858df79309ecPython
source code: wallaby_vk_2.3.4_sourcecode.zip
English Summary
Wallaby-VK is a free virtual on-screen keyboard for Linux
systems with Wayland support. It runs as a floating,
focus-stealing-free keyboard at the bottom of the screen.
Key features: Full German QWERTZ layout
with umlauts (ä, ö, ü, ß) and a working acute dead-key (´ +
e → é), 40 customizable text snippets, local speech
recognition via faster-whisper, 10-slot multi-copy buffer
with an event-based clipboard watcher (safe on KWin 6 /
Plasma 6), modifier locking (Shift, Ctrl, Alt, AltGr),
Meta-as-quasi-modifier for Plasma shortcuts (Meta+E for the
file manager, Meta+. for the emoji picker, etc.), audio
controls, and an optional KeyCast OSD that shows keystrokes
(including modifier combos like Ctrl+C), mouse buttons, and
scroll-wheel events as live tokens on screen — ideal for
screencasts and tutorials.
Tested on Kubuntu 26.04 / KDE Plasma 6 / KWin 6, Ubuntu
24.04, Linux Mint 22.3 (Cinnamon), TUXEDO-OS-202604.
Single Python file, packed as AppImage — 'installation'
included.
Überblick
Wallaby-VK ist ein virtuelles On-Screen-Keyboard für
Linux-Systeme mit Wayland-Unterstützung. Es ist als einzelne
Python-Datei realisiert, benötigt keine Installation über
Paketmanager und läuft direkt nach dem Start als schwebende,
fokuslose Tastatur am unteren Bildschirmrand.
Mit Claude.AI ist der Python-Code unter der Linux Distri
Kubuntu entstanden.
Ein Schnelltest mit Ubuntu-24.04.4-desktop-amd64,
TUXEDO-OS-202604 und linuxmint-22.3-cinnamon-64bit war
positiv.
Das dunkle, rahmenlose Design mit flachen Kacheln fügt sich unauffällig in moderne Desktop-Umgebungen ein.
Features
📝40 Textbausteine
Häufig benötigte Texte per Klick einfügen. Unterstützt Datum/Zeit-Variablen (ISO 8601). Editierbar, sortierbar, Sync via Nextcloud.
🎤Spracheingabe
Lokale Spracherkennung via faster-whisper. Modellauswahl per Rechtsklick (tiny bis large-v3). Komplett offline.
▶Demo-Video + 🔊📋Multi-Copy-Buffer
Zwischenablage mit FIFO-Speicher für 10 Einträge. Rechtsklick auf Paste zeigt die Auswahl.
📺KeyCast (KC)
Optionales OSD für Screencasts und Tutorials: gedrückte
Tasten, Modifier-Kombos (Ctrl+C, Shift+A), Maustasten und
Scrollrad-Events erscheinen als Live-Tokens auf dem
Bildschirm.
🔒Modifier-Einrasten
Shift, Ctrl, Alt, AltGr: Aus → One-Shot → Lock. One-Shot mit 5s-Countdown-Balken. Lock hält systemweit.
🔊Audio-Steuerung
Lautstärke-Tasten mit Lautstärken-Bargraph und Mute-LED. Betätigen, der Lautstärkentaste ändert um 1%, das Drehen des Rollrates auf den Tasten ändert um 5%.
🗐Bearbeiten-Tasten
Die Standard-Bearbeitungsfunktionen Cut, Paste, Undo, All und Find sind als extra Tasten abgebildet.
⌨️QWERTZ + Umlaute
Vollständiges deutsches Layout mit ä, ö, ü, ß. Live-Beschriftung wechselt bei Shift, AltGr und Caps Lock. Rechtsklick sendet die Shift-Variante. Akut-Dead-Key funktioniert: ´ + e → é, ´ + a → á usw.
Modifier-Zustände
Jeder Modifier (Shift, Ctrl, Alt, AltGr) hat drei Zustände. Klicken schaltet weiter:
Im One-Shot-Modus zeigt ein gelber Countdown-Balken am unteren Tastenrand die verbleibende Zeit (5 Sekunden). Lock hält den Modifier systemweit — auch Mausklicks in anderen Fenstern erhalten den Modifier (z. B. Ctrl+Klick im Dateimanager).
Meta hat einen eigenen Modus und kennt keinen Lock — das wäre mit dem Plasma-Startmenü-Verhalten unvereinbar. Der 1. Klick auf Meta drückt die Taste via UInput und startet einen 2-Sekunden-Timer. Wird innerhalb dieser Zeit eine andere Wallaby-Taste geklickt, wird die Kombination (z. B. Meta+E für den Dateimanager, Meta+. für den Emoji-Picker) gesendet und Meta sofort losgelassen. Ein 2. Klick auf Meta oder das Ablaufen des Timers ohne Folgetaste lässt Meta los — Plasma erkennt einen Solo-Press und öffnet das Startmenü.
KeyCast (KC)
KeyCast ist eine optionale On-Screen-Anzeige für gedrückte Tasten und Mausaktionen. Sie ist gedacht für Screencasts, Tutorials, Vorträge und Demos — also überall dort, wo das Publikum sehen soll, welche Tasten gerade benutzt werden. KeyCast wird in der Wallaby-Konfiguration aktiviert: Sektion „KeyCast (KC)" → Häkchen bei „KC aktivieren".
Sobald KC aktiv ist, erscheint eine zusätzliche KC-Taste
auf Wallaby. Sie schaltet zwischen zwei Modi um:
| Modus | Verhalten |
|---|---|
| Edit-Modus | Ein hellblau umrandetes Rechteck erscheint auf dem Bildschirm. Per Drag&Drop lässt sich die Position frei wählen — auch über Monitorgrenzen hinweg. Die gewählte Position wird gespeichert. |
| OSD-Modus | An der zuvor festgelegten Position erscheinen Tokens für jede gedrückte Taste und jeden Mausklick. Jedes Token bleibt 3 Sekunden sichtbar und verschwindet dann automatisch. |
Was angezeigt wird
KeyCast liest direkt von /dev/input/event* —
angezeigt werden also Eingaben von der echten Tastatur und
Maus, nicht nur Wallaby-eigene Tasten:
| Eingabe | Anzeige |
|---|---|
| Einzelne Taste | Token mit Tasten-Label, z. B. A, Return,
F5 |
| Modifier-Kombination | Prefix vor dem Tasten-Label: Ctrl+C, Shift+A,
Alt+Tab, AltGr+E |
| Modifier alleine | Wird bewusst nicht als Token angezeigt — erst die Kombination zählt |
| Maustasten | Links, rechts, Mitte |
| Scrollrad | Vertikal und horizontal |
| Dieselbe Taste wiederholt | Wird innerhalb von 1,5 s zu einem Token mit
Multiplikator zusammengefasst: Backspace ×7 |
Anpassbar
In der Wallaby-Konfiguration lassen sich Erscheinungsbild und Größe einstellen — Farbwerte über den neuen dunklen Farbdialog:
| Option | Bereich | Default |
|---|---|---|
| Schriftgröße | 10 – 62 pt | 16 pt |
| Rahmen-Farbe | RGB | #00AAFF (hellblau) |
| Token-Hintergrund | RGB | #232629 (dunkelgrau) |
| Token-Vordergrund | RGB | #21C063 (grün) |
| Multiplier-Farbe (×N) | RGB | #21C063 |
| Hintergrund-Transparenz | 0 – 100 % | 0 % (opak) |
Architektonisch ist jedes Token ein eigenes Toplevel-Fenster
— das erlaubt echte Transparenz (tk's -alpha
vererbt sich an Kinder, ein gemeinsamer Container wäre also
nicht echt unsichtbar zu bekommen). Das Lesen der Eingaben
passiert in einem Background-Thread, der laufende
Wallaby-Eingaben nicht blockiert.
Installation
Voraussetzungen
| Komponente | Details |
|---|---|
| Betriebssystem | Linux mit Wayland (getestet: Kubuntu 26.04 / KDE
Plasma 6) auf AMD und intel Ein Schnelltest mit Ubuntu-26.04.4-desktop-amd64, linuxmint-22.3-cinnamon-64bit und TUXEDO-OS-202604211002 war positiv. |
| Laufzeit-Abhängigkeiten gebündelt | Python, tkinter, python-evdev und wl-clipboard sind in der AppImage enthalten — keine separate Installation nötig. |
Gruppe input erforderlich |
Für UInput-Zugriff (Kernel-Level-Eingabe). Wird bei der System-Integration auf Wunsch automatisch eingerichtet. |
| pactl empfohlen | Audio-Steuerung (PulseAudio / PipeWire) — auf den meisten Desktops vorhanden. |
| faster-whisper optional | Spracheingabe (lokales Whisper-Modell). Wegen der Größe nicht gebündelt; bei Bedarf separat nachinstallierbar. |
Schritt 1 — Entpacken & ausführbar machen
Das heruntergeladene Archiv entpacken und die AppImage ausführbar machen:
unzip Wallaby-VK-2.3.1-x86_64.AppImage.zip chmod +x Wallaby-VK-2.3.1-x86_64.AppImage
Alternativ per Rechtsklick → Eigenschaften → „Ausführen als Programm erlauben".
Schritt 2 — Starten
Per Doppelklick im Dateimanager oder im Terminal:
./Wallaby-VK-2.3.1-x86_64.AppImage
Beim ersten Start bietet Wallaby die System-Integration an
(Desktop-Eintrag, Autostart, udev-Regeln und Aufnahme in die
Gruppe input für den UInput-Zugriff). Nach dem
Einrichten der Gruppe einmal ab- und wieder anmelden.
Die Tastatur erscheint am unteren Rand des Hauptmonitors.
Schritt 3 — Aktualisieren
Wallaby bringt einen eingebauten Update-Mechanismus mit:
./Wallaby-VK-2.3.1-x86_64.AppImage --update
Die aktuell installierte Version zeigt --version.
Command-Line-Parameter
Die AppImage versteht folgende Schalter (Übersicht auch über
--help):
| Parameter | Wirkung |
|---|---|
--install, --integrate |
Nach ~/.local/bin/ kopieren und
Menüeintrag anlegen |
--uninstall, --remove |
Menüeintrag, Autostart, Icon und installierte Kopie entfernen |
--update |
Installation auf die Version dieser Datei aktualisieren |
--version, -V |
Version dieser AppImage anzeigen |
--autostart-on |
Autostart bei der Anmeldung aktivieren |
--autostart-off |
Autostart deaktivieren |
--install-whisper |
Spracheingabe (faster-whisper) nachinstallieren |
--setup |
Geführte Ersteinrichtung erneut ausführen |
--help, -h |
Hilfe anzeigen |
Konfiguration
Textbausteine und Einstellungen werden als JSON gespeichert:
| Priorität | Pfad | Bemerkung |
|---|---|---|
| 1 | ~/Nextcloud/ |
Falls vorhanden — automatischer Sync |
| 2 | ~/.config/wallaby-vk/ |
Fallback — wird automatisch erstellt |
Bedienung
| Aktion | Wirkung |
|---|---|
| Linksklick auf Taste | Zeichen senden (Auto-Repeat bei gedrückt halten: 500 ms Delay, 43 ms Rate) |
| Rechtsklick auf Taste | Shift-Variante einmalig senden |
| Linksklick auf Modifier (Shift/Ctrl/Alt/AltGr) | Zustand weiterschalten: Aus → One-Shot → Lock → Aus |
| Linksklick auf Meta | Meta für 2 s halten; Folgetaste sendet Kombination, sonst Solo-Press (Startmenü) |
| Klick auf ´ (Akut), dann auf einen Vokal | Dead-Key-Kombination: ´ + e → é, ´ + a → á usw. |
| Rechtsklick auf Paste | Copy-Buffer-Auswahl öffnen |
| Rechtsklick auf 🎤 | Whisper-Modell auswählen |
| Ziehen auf Hintergrund | Tastatur-Fenster verschieben |
Klick auf KC-Taste |
KeyCast-Modus wechseln: Edit ↔ OSD (nur sichtbar wenn KC aktiviert) |
| Drag auf KC-Edit-Rahmen | OSD-Position auf dem Bildschirm festlegen |
Textbausteine
Über die Taste ☰▼ oben links öffnet sich das
Textbausteine-Fenster. Linksklick sendet den Text, Rechtsklick
öffnet den Editor. Mit der Sort-Funktion kann die Reihenfolge
per ▲/▼ geändert werden.
Datum/Zeit-Bausteine verwenden ISO-8601-Platzhalter: DD.MM.YYYY
wird zu z. B. 05.04.2026. Variablen: YYYY,
YY, MM, DD, hh,
mm, ss.
Deinstallation
Schritt 1 — AppImage & Integration entfernen
Am einfachsten über den eingebauten Schalter — er entfernt
Menüeintrag, Autostart, Icon und die installierte Kopie in ~/.local/bin/:
./Wallaby-VK-2.3.1-x86_64.AppImage --uninstall
Danach die heruntergeladene AppImage-Datei löschen. Wurde die Integration nicht genutzt oder soll manuell aufgeräumt werden, reichen:
rm ~/.local/share/applications/wallaby-vk.desktop rm ~/.config/autostart/wallaby-vk.desktop
Schritt 2 — Konfiguration löschen
rm -rf ~/.config/wallaby-vk/
Falls Nextcloud als Speicherort verwendet wird:
rm ~/Nextcloud/.wallaby-vk_snippets.json rm ~/Nextcloud/.wallaby-vk_settings.json
Schritt 3 — Optional: udev-Regel entfernen
Falls bei der Integration eine udev-Regel angelegt wurde:
sudo rm /etc/udev/rules.d/*wallaby*.rules
Schritt 4 — Optional: Benutzer aus Gruppe input
entfernen
sudo gpasswd -d $USER input
Technische Details
| Eigenschaft | Wert |
|---|---|
| Sprache | Python 3.10+ |
| GUI-Framework | tkinter (XWayland) |
| Eingabemethode | python-evdev UInput (Kernel-Level) |
| Layout | QWERTZ (de) mit Akut-Dead-Key (´) |
| Clipboard | wl-paste --watch (event-basiert), mit
3-s-Polling-Fallback für X11 oder fehlendes wl-clipboard |
| KeyCast (KC) | Eigener /dev/input/event*-Reader im
Background-Thread; pro Token ein eigenes
Toplevel-Fenster für echte Transparenz; 10–62 pt
Schriftgröße, RGB-Farben einstellbar |
| Distribution | AppImage (x86_64, alle Laufzeit-Abhängigkeiten gebündelt) mit eingebautem Update-Mechanismus |
| Konfiguration | JSON (Textbausteine, Einstellungen) |
| Lizenz | Programmcode: MIT-Lizenz Du darfst die Software kostenlos benutzen, kopieren, ändern, weitergeben und verkaufen. Ich gebe keine Garantie und hafte nicht für Schäden oder Probleme. Icons: CC BY-SA 4.0 Logo: ausgenommen — Kennzeichen von Bekudio Details siehe Lizenzen. |
Lizenzen
Wallaby-VK selbst
| Bestandteil | Lizenz |
|---|---|
| Programmcode | MIT-Lizenz |
Tasten- und Oberflächen-Icons (assets-wallaby-vk/) |
CC BY-SA 4.0 |
Logo und Wallaby-Figur (wallaby-vk_logo.png,
wallaby-vk_front.png, wallaby-vk_side.png) |
Ausgenommen — Kennzeichen von Bekudio, alle Rechte vorbehalten |
Der Programmcode steht unter der MIT-Lizenz: Du darfst ihn kostenlos benutzen, kopieren, ändern, weitergeben und verkaufen. Ich gebe keine Garantie und hafte nicht für Schäden oder Probleme.
Die Icons stehen unter CC BY-SA 4.0 — teilen und bearbeiten ist erlaubt, auch kommerziell, sofern du Bekudio nennst und Bearbeitungen unter derselben Lizenz weitergibst.
Logo und Wallaby-Figur sind davon ausgenommen. Sie dürfen unverändert mit unveränderten Kopien von Wallaby-VK weitergegeben und verwendet werden, um auf das Projekt hinzuweisen — etwa in Artikeln oder Paketübersichten. Nicht erlaubt ist die Verwendung für andere Software oder Produkte, eine Verwendung, die den Eindruck erweckt, dein Produkt stamme von Bekudio, die Anmeldung als eigene Marke sowie die Verbreitung veränderter Fassungen. Wer eine veränderte Fassung von Wallaby-VK weitergibt, sollte eigene Grafiken verwenden — so bleibt für Nutzer erkennbar, welche Fassung von Bekudio stammt.
English: The program code is MIT-licensed — use, copy, modify, share, and sell it for free; no warranty, no liability. The icons are CC BY-SA 4.0. The logo and the Wallaby figure are excluded as trademarks of Bekudio: redistribute them only with unmodified copies, and use your own artwork for modified versions.
Gebündelte Software Dritter
Das AppImage enthält neben Wallaby-VK auch Software von
Dritten. Diese steht unter eigenen Lizenzen, die unabhängig
von den oben genannten gelten. Die vollständigen Lizenztexte
liegen im AppImage unter usr/share/licenses/ und
lassen sich so einsehen:
./Wallaby-VK-2.3.1-x86_64.AppImage --appimage-extract
cat squashfs-root/usr/share/licenses/README.txtZusätzlich liegen dem Download die Dateien LICENSE
und THIRD-PARTY-LICENSES.md bei — dort steht
dieselbe Übersicht ohne Entpacken lesbar.
| Komponente | Lizenz | Herkunft |
|---|---|---|
wl-copy, wl-paste
(wl-clipboard) |
GPL-3.0-or-later | github.com/bugaevc/wl-clipboard |
| AppImage-Laufzeit (AppRun) | MIT | github.com/AppImage/AppImageKit |
| Python / tkinter (Tcl-Tk) | PSF / Tcl-Tk (BSD-artig) | vom System bereitgestellt |
| python-evdev | BSD-3-Clause | vom System bereitgestellt |
| sounddevice / PortAudio | MIT / MIT-artig | vom System bereitgestellt |
| faster-whisper / CTranslate2 | MIT | optional, nur bei aktivierter Spracheingabe |
wl-clipboard — Quellcode-Angebot (GPLv3)
Die mitgelieferten Programme wl-copy und wl-paste
stammen unverändert aus dem öffentlichen Quellcode von
wl-clipboard (Tag v2.3.0) und wurden lediglich
neu kompiliert. Der vollständige Quellcode ist unter der oben
genannten Adresse abrufbar. Auf Anfrage stelle ich ihn
zusätzlich direkt bereit — Kontakt siehe Impressum.
Wallaby-VK ruft wl-copy und wl-paste
ausschließlich als eigenständige Programme auf. Es besteht
keine Verlinkung im Sinne der GPL; die MIT-Lizenz von
Wallaby-VK bleibt davon unberührt.