Sprache wird unter Linux zu Text.

Blitztext Linux nimmt deine Stimme per Hotkey oder Klick auf, transkribiert sie standardmäßig lokal mit Whisper und legt den Text in die Zwischenablage – auf Wunsch mit automatischem Einfügen in die aktive Anwendung. Optionale KI-Workflows verbessern den Text, bevor du ihn weiterverwendest.

Installation ansehen Quellcode auf GitHub

Lizenz: MIT, Open Source
Fokus: KDE Plasma & Wayland
Transkription: Lokal mit Whisper

Single-Panel-Widget von Blitztext Linux mit goldenem Mikrofon-Button, Statusanzeige „Bereit“ und Werkzeugleiste für Compose, Verlauf, Vorlesen und Einstellungen — Das echte Single-Panel-Widget von Blitztext Linux

Warum Blitztext Linux?

Schnell diktieren

Hotkey drücken oder klicken, sprechen, fertig. Aufnahme, Transkription und Ausgabe laufen ohne Umwege durch andere Programme.

Lokal transkribieren

Die Spracherkennung läuft standardmäßig auf deinem Rechner – mit openai-whisper oder faster-whisper, ohne dass Audio deinen Computer verlässt.

Optional verbessern

KI-Workflows formulieren um, glätten den Ton oder ergänzen Emojis – nur wenn du sie bewusst auswählst und einen API-Key hinterlegt hast.

Kopieren oder automatisch einfügen

Der fertige Text landet in der Zwischenablage. Mit aktivem ydotoold fügt Blitztext ihn auf Wunsch direkt an der Cursorposition ein.

Kompakte Desktop-App

Ein schlankes, rahmenloses PyQt6-Widget mit Tray-Icon und deutsch-englischer Oberfläche – gebaut für KDE Plasma unter Wayland.

So funktioniert es

Aufnahme starten

Per globalem Hotkey (Alt halten) oder per Klick auf das goldene Mikrofon im Widget bzw. im Tray-Menü. Widget und Tray-Icon zeigen den Status: grün bereit, Aufnahme mit laufendem Timer und Wellenbalken.
Transkribieren und optional überarbeiten

Whisper wandelt die Aufnahme lokal in Text um. Auf Wunsch überarbeitet ein KI-Workflow das Ergebnis – mit wählbarer Text-Aktion und einsehbarem Prompt.
Kopieren oder einfügen

Der Text liegt in der Zwischenablage. Ist Auto-Paste aktiv, fügt Blitztext ihn direkt in die Anwendung ein, in der dein Cursor steht.

Single-Panel-Widget von Blitztext Linux während einer laufenden Aufnahme mit Timer und animierten Wellenbalken — Widget: Aufnahme läuft

Funktionen

Alles hier Beschriebene ist im App-Repository dokumentiert und in der Oberfläche nachvollziehbar.

Fünf Workflows per Hotkey

Vom reinen Diktat bis zur KI-Umformulierung: Jeder Workflow hat einen eigenen globalen Hotkey und ist auch per Tray-Menü und Widget erreichbar.

Single-Panel-Widget

Ein kompaktes, rahmenloses Fenster mit goldenem Mikrofon-Button, Statuspunkt, Timer, Wellenbalken und einer Werkzeugleiste für Compose, Verlauf, Vorlesen und Einstellungen.

Fünf Text-Aktionen

Text verbessern, Kürzen, Ausformulieren, Tonfall ändern oder eine eigene Anweisung – wählbar im Widget, im Compose-Fenster und in den Einstellungen.

Compose-Fenster

Text tippen, einfügen oder hineindiktieren und ohne Mikrofon-Umweg per KI überarbeiten lassen – mit Text-Aktion, Tonfall-Auswahl und Signatur-Unterstützung.

Variantenverlauf

Die KI-Ergebnisse einer Sitzung bleiben im Compose-Fenster erhalten – jederzeit über die Pfeile am Ergebnisfeld durchblättern.

Prompt-Transparenz

Vor jedem KI-Aufruf lassen sich System-Prompt und Nutzernachricht anzeigen und vollständig bearbeiten. Keine Blackbox.

Diktatmodus und Verlauf

Im Diktatmodus wird jedes Transkript als Markdown-Notiz gespeichert und auf Wunsch zusammengeführt. Der Verlauf hält die letzten Transkripte bereit.

Vorlesen mit Audio-Export

Beliebigen Text vorlesen lassen – lokal mit Piper TTS (Standard) oder optional per OpenAI Cloud TTS – und die Ausgabe als Audiodatei exportieren.

Eigene Begriffe

Namen, Fachwörter und Spezialbegriffe lassen sich hinterlegen, damit Transkription und KI-Workflows sie korrekt schreiben.

Deutsch und Englisch

Die App-Oberfläche gibt es vollständig auf Deutsch und Englisch – umschaltbar in den Einstellungen.

Konfiguration und Secrets getrennt

Die Konfiguration liegt mit restriktiven Rechten (0600) unter ~/.config/blitztext-linux/. API-Keys stehen nie in der Config, sondern kommen aus Umgebungsvariablen (secrets.env).

Die fünf Workflows

Workflow	Hotkey	KI	Beschreibung
Diktieren	`Alt (halten)`	Nein	Standard: aufnehmen, transkribieren, Text ausgeben.
Diktieren · lokal	`Meta + Shift + H`	Nein	Erzwingt eine rein lokale Offline-Transkription.
Diktieren & verbessern	`Meta + Shift + T`	Ja	Transkribiert und schreibt das Ergebnis mit der gewählten Text-Aktion um.
Sachlich formulieren	`Meta + Shift + D`	Ja	Dampf ablassen: macht aus Frust eine sachliche Nachricht.
Emojis ergänzen	`Meta + Shift + E`	Ja	Reichert die Nachricht mit passenden Emojis an.

Workflows mit KI-Kennzeichnung benötigen einen API-Key für OpenAI, OpenRouter oder einen eigenen OpenAI-kompatiblen Endpoint. Ohne Key bleiben sie deaktiviert – Diktat und lokale Transkription funktionieren weiterhin.

Screenshots

Echte Ansichten aus Blitztext Linux – keine Mockups.

Single-Panel-Widget mit goldenem Mikrofon-Button, grünem Statuspunkt, Anzeige „Bereit“ und Werkzeugleiste — Widget: bereit

Single-Panel-Widget während einer laufenden Aufnahme mit gelbem Statuspunkt, Timer und animierten Wellenbalken — Widget: Aufnahme läuft

Single-Panel-Widget während der Transkription mit rotierendem goldenem Fortschrittsring um das Mikrofon — Widget: Transkription

Aktions-Menü des Widgets mit Diktieren & verbessern, Text-Aktion, eigener Anweisung, Sammel-Diktat und Verwerfen — Widget: Aktions-Menü

Compose-Fenster mit Entwurfsbereich links, KI-Ergebnis rechts, Text-Aktion sowie Schaltflächen zum Verbessern, Kopieren und Einfügen — Compose-Fenster (Entwurf)

Compose-Fenster mit ausgeklappter eigener Anweisung und Schaltfläche zum Prüfen des Prompts — Compose-Fenster: eigene Anweisung

Einstellungen, Tab Spracherkennung: Whisper-Modell, Backend, Sprache, Hotkey-Modus und Aufnahmetaste — Einstellungen: Spracherkennung

Einstellungen, Tab Text & KI: System-Prompt, API-Key-Umgebungsvariable, LLM-Anbieter, Basis-URL, Modell, Text-Aktion und Emoji-Dichte — Einstellungen: Text & KI

Einstellungen, Tab Allgemein: Auto-Paste, Notizordner, Verlaufsgröße, Sprache der Oberfläche und Signatur — Einstellungen: Allgemein

Verlaufsfenster mit den letzten Transkripten und Schaltflächen zum Kopieren und Löschen einzelner Einträge — Transkript-Verlauf

Vorlesen-Fenster mit Texteingabe, Stimmen-Auswahl und Schaltflächen zum Vorlesen und Exportieren als Audiodatei — Vorlesen mit Audio-Export

Tray-Kontextmenü mit allen fünf Workflows, Compose-Fenster, Text-Aktionen, Diktatmodus, Verlauf und Einstellungen — Tray-Menü

Der Status auf einen Blick

Das Tray-Icon zeigt jederzeit, was Blitztext gerade tut:

Grün: bereit
Rot: Aufnahme läuft
Orange: Transkription/KI arbeitet
Grau: Fehler

Local-first – Cloud nur, wenn du willst

Blitztext trennt klar zwischen lokaler Verarbeitung und optionalen Cloud-Funktionen.

Läuft lokal auf deinem Rechner

Whisper-Transkription (openai-whisper oder faster-whisper) – der Workflow „Blitztext Local“ erzwingt sie sogar ausdrücklich
Vorlesen mit Piper TTS (Standard-Anbieter)
Diktat-Notizen und Verlauf – gespeichert ausschließlich in deinem Home-Verzeichnis
Konfiguration unter ~/.config/blitztext-linux/ mit Dateirechten 0600

Optional: Cloud-Funktionen

KI-Workflows (Diktieren & verbessern, Sachlich formulieren, Emojis ergänzen) und das Compose-Fenster nutzen einen LLM-Anbieter: OpenAI, OpenRouter oder einen eigenen OpenAI-kompatiblen Endpoint
Cloud-TTS über OpenAI als Alternative zu Piper – mit einmaliger, ausdrücklicher Bestätigung vor der ersten Nutzung
Ein API-Key wird nur für diese optionalen Funktionen benötigt – hinterlegt als Umgebungsvariable, nie in der Konfigurationsdatei

Wichtig: Wenn du Cloud-Funktionen aktivierst, wird der zu verarbeitende Text (bzw. das Transkript) an den von dir gewählten Anbieter übertragen. Ohne aktivierte Cloud-Funktionen und ohne API-Key bleiben Aufnahme und Transkription auf deinem Rechner.

Installation

Der empfohlene Weg ist das Installationsskript aus dem App-Repository. Es ist idempotent, prüft dein System (Ubuntu/Debian-Basis) und richtet alles ein – inklusive virtueller Python-Umgebung und Whisper.

1. Installieren
```
git clone https://github.com/TimInTech/blitztext-linux.git
cd blitztext-linux
bash scripts/install.sh
```
Das Skript fragt den Betriebsmodus ab: globale Hotkeys (erfordert die input-Gruppe) oder Bedienung nur über Fenster und Tray.
2. Installation prüfen
```
bash scripts/verify.sh
```
Wichtig bei Hotkey-Modus: einmal neu anmelden oder neu starten, damit die input-Gruppe aktiv wird. Das Skript liefert Diagnose zu X11/Wayland und Clipboard-Backends.
3. Manuell starten
```
./run.sh
```
Erscheint das Tray-Icon und reagieren die Hotkeys? Dann ist alles eingerichtet.
4. Autostart aktivieren (optional)
```
systemctl --user start blitztext-linux
```
Startet Blitztext als systemd-User-Service.

Alle Details, manuelle Installation und Fehlersuche: Setup-Dokumentation im App-Repository

Hinweis zu Flatpak: Im App-Repository existiert ein experimenteller Flatpak-Manifest-Spike. Er ist kein Release-Kanal und nicht auf Flathub veröffentlicht. In der Sandbox fehlen zudem globale Hotkeys, Auto-Paste und die lokale Whisper-Transkription. Empfohlen bleibt das Installationsskript.

Kompatibilität

Blitztext Linux wird auf Kubuntu mit KDE Plasma unter Wayland entwickelt und ist dort sowie auf Ubuntu 24.04 und 26.04 mit GNOME unter Wayland getestet. Linux Mint und Lubuntu bleiben ungetestet.

System	Session	Status	Hinweise
Kubuntu 26.04, KDE Plasma	Wayland	Getestet	Referenzumgebung; ydotool ≥ 1.0 direkt über apt verfügbar.
Ubuntu 24.04, GNOME	Wayland	Getestet	Clean-Install und Live-Test abgeschlossen; ydotool 0.1.8 wird über symbolische Tastenkombinationen unterstützt.
Ubuntu 26.04, GNOME	Wayland	Getestet	Clean-Install und Live-Test abgeschlossen: GUI, Tray, Aufnahme, lokales Whisper, Hotkey, Zwischenablage, Auto-Paste und Autostart geprüft.
Linux Mint 22.x, Cinnamon	X11	Ungetestet	Ungetestet. xclip ist voraussichtlich das Clipboard-Backend; Session und ydotoold separat prüfen.
Lubuntu 24.04 / 26.04, LXQt	X11 / Wayland	Ungetestet	Ungetestet. Der Session-Typ bestimmt das Clipboard-Backend – scripts/verify.sh zeigt, was gilt.

Diese Matrix beschreibt verifizierte Tests und bekannte Voraussetzungen. Sie ist keine Supportzusage für ungetestete Systeme.

Einschränkungen, die du kennen solltest

Auto-Paste benötigt ein laufendes ydotoold. Blitztext unterstützt Ubuntu 24.04s ydotool 0.1.8 mit symbolischen Tastenkombinationen und ydotool ≥ 1.0 mit rohen Keycodes.
Globale Hotkeys nutzen evdev und erfordern die Mitgliedschaft in der input-Gruppe. Systemweit können damit alle Prozesse des Benutzers Eingaben mitlesen – Blitztext daher nur in vertrauenswürdigen Umgebungen einsetzen.
Ohne globale Hotkeys bleibt Blitztext voll bedienbar – über das Widget und das Tray-Menü.
Fehlt ein Tray-Bereich, fällt das Icon auf das System-Theme zurück; die Farbkodierung kann dann entfallen.

Häufige Fragen

Läuft Blitztext vollständig lokal?

Die Transkription läuft standardmäßig lokal mit Whisper, ebenso das Vorlesen mit Piper. Vollständig lokal bleibt Blitztext, solange du keine KI-Workflows oder Cloud-TTS nutzt. Aktivierst du diese optionalen Funktionen, wird der zu verarbeitende Text an den gewählten Anbieter (z. B. OpenAI oder OpenRouter) übertragen.

Brauche ich einen API-Key?

Nur für die optionalen KI-Funktionen: die Workflows Diktieren & verbessern, Sachlich formulieren und Emojis ergänzen, das Compose-Fenster und Cloud-TTS. Diktat und lokale Transkription funktionieren ohne Key. Der Key wird als Umgebungsvariable hinterlegt (z. B. in ~/.config/blitztext-linux/secrets.env), nie in der Konfigurationsdatei.

Welche Linux-Systeme sind getestet?

Getestet sind Kubuntu mit KDE Plasma unter Wayland sowie Ubuntu 24.04 und 26.04 mit GNOME unter Wayland. Linux Mint (Cinnamon) und Lubuntu (LXQt) bleiben ungetestet; die Kompatibilitätsmatrix oben ist eine Diagnose-Einordnung, keine Supportzusage.

Funktioniert Auto-Paste unter Wayland?

Ja. Getestet auf Kubuntu mit KDE Plasma sowie Ubuntu 24.04 und 26.04 mit GNOME unter Wayland. Ubuntu 24.04s ydotool 0.1.8 nutzt symbolische Tastenkombinationen, ydotool ≥ 1.0 rohe Keycodes. Voraussetzung bleibt ein laufendes ydotoold; ungetestete Systeme erhalten daraus keine Supportzusage.

Kann ich Blitztext ohne globalen Hotkey verwenden?

Ja. Das Installationsskript bietet einen Modus ohne globale Hotkeys an. Aufnahme, Workflows, Diktat und Verlauf sind vollständig über das Widget und das Tray-Menü bedienbar.

Wo werden Konfiguration und Secrets gespeichert?

Die Konfiguration liegt unter ~/.config/blitztext-linux/config.json und wird mit restriktiven Rechten (0600) geschrieben. API-Keys stehen nie in dieser Datei – sie werden zur Laufzeit aus Umgebungsvariablen gelesen, empfohlen über ~/.config/blitztext-linux/secrets.env.

Ist Blitztext kostenlos und Open Source?

Ja. Blitztext Linux ist Open Source unter der MIT-Lizenz und kostenlos. Der gesamte Quellcode liegt öffentlich auf GitHub. Kosten können nur bei den optionalen Cloud-Anbietern entstehen, wenn du deren APIs mit eigenem Key nutzt.

Ist Flatpak bereits der empfohlene Installationsweg?

Nein. Es gibt einen experimentellen Flatpak-Spike im Repository, aber keinen Flatpak-Release-Kanal und keine Flathub-Veröffentlichung. In der Sandbox fehlen außerdem globale Hotkeys, Auto-Paste und lokales Whisper. Empfohlen ist das Installationsskript scripts/install.sh.

Bereit zum Diktieren?

Blitztext Linux ist Open Source, kostenlos und in wenigen Minuten eingerichtet.

Jetzt installieren Neuestes Release ansehen