Version 0.8.1

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.

Lizenz
MIT, Open Source
Fokus
KDE Plasma & Wayland
Transkription
Lokal mit Whisper
Hauptfenster von Blitztext Linux mit Workflow-Auswahl, Schreibstil-Vorlage, Aufnahmeknopf und Statusanzeige „Bereit“
Das echte Hauptfenster von Blitztext Linux v0.8.1

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 ydotool ab Version 1.0 fügt Blitztext ihn auf Wunsch direkt an der Cursorposition ein.

Kompakte Desktop-App

Eine schlanke PyQt6-Anwendung mit Tray-Icon, Hauptfenster und deutsch-englischer Oberfläche – gebaut für KDE Plasma unter Wayland.

So funktioniert es

  1. Aufnahme starten

    Per globalem Hotkey (z. B. Meta+H) oder per Klick im Hauptfenster bzw. Tray-Menü. Das Tray-Icon zeigt den Status: grün bereit, rot Aufnahme.

  2. Transkribieren und optional überarbeiten

    Whisper wandelt die Aufnahme lokal in Text um. Auf Wunsch überarbeitet ein KI-Workflow das Ergebnis – mit wählbarem Schreibstil und einsehbarem Prompt.

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

Hauptfenster von Blitztext Linux während einer laufenden Aufnahme mit rotem Statusindikator
Laufende Aufnahme

Funktionen

Alles hier Beschriebene ist im aktuellen Release v0.8.1 enthalten und im App-Repository dokumentiert.

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 Hauptfenster erreichbar.

Schreibstil-Presets

Neun fertige Vorlagen – von „E-Mail formell“ über „Stichpunkte“ bis „Kurz & präzise“ – plus eine frei definierbare eigene Vorlage.

Compose-Fenster

Text tippen oder einfügen und ohne Mikrofon per KI überarbeiten lassen – mit Workflow-, Preset- und Tonfall-Auswahl sowie Signatur-Unterstützung.

Variantenverlauf

Die letzten zehn KI-Ergebnisse einer Sitzung bleiben im Compose-Fenster erhalten – jederzeit vergleichen und per Klick wiederherstellen.

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
Blitztext Meta + H Nein Standard: aufnehmen, transkribieren, Text ausgeben.
Blitztext Local Meta + Shift + H Nein Erzwingt eine rein lokale Offline-Transkription.
Blitztext+ Meta + Shift + T Ja Formuliert die Aufnahme professionell um – mit wählbarem Schreibstil.
Blitztext $%&! Meta + Shift + D Ja Dampf ablassen: macht aus Frust eine sachliche Nachricht.
Blitztext :) 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 v0.8.1 – keine Mockups.

Hauptfenster mit Workflow-Dropdown, Schreibstil-Vorlage, Aufnahmeknopf, Status „Bereit“ sowie Schaltflächen für Diktat und Verlauf
Hauptfenster
Hauptfenster während einer laufenden Aufnahme mit rotem Statuspunkt und laufender Zeitanzeige
Laufende Aufnahme
Compose-Fenster mit Entwurfsbereich links, KI-Ergebnis rechts, Workflow- und Vorlagenauswahl sowie Schaltflächen zum Verbessern, Kopieren und Einfügen
Compose-Fenster (Entwurf)
Einstellungen, Tab Spracherkennung: Whisper-Modell, Backend, Sprache, Hotkey-Modus und Aufnahmetaste
Einstellungen: Spracherkennung
Einstellungen, Tab KI-Workflows: LLM-Anbieter, API-Key-Umgebungsvariable, Basis-URL, Modell, Tonfall und Schreibstil-Vorlage
Einstellungen: KI-Workflows
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, Schreibstil-Vorlagen, Diktatmodus, Verlauf und Einstellungen
Tray-Menü

Der Status auf einen Blick

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

  • Grünes Mikrofon-Tray-Icon Grün: bereit
  • Rotes Mikrofon-Tray-Icon Rot: Aufnahme läuft
  • Oranges Mikrofon-Tray-Icon Orange: Transkription/KI arbeitet
  • Graues Mikrofon-Tray-Icon 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 (Blitztext+, Blitztext $%&!, Blitztext :)) 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. 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. 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. 3. Manuell starten

    ./run.sh

    Erscheint das Tray-Icon und reagieren die Hotkeys? Dann ist alles eingerichtet.

  4. 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 systematisch getestet. Andere Ubuntu-/Debian-basierte Systeme können funktionieren, sind aber nicht systematisch getestet.

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 Ungetestet apt liefert nur ydotool 0.1.x → kein Auto-Paste (Zwischenablage funktioniert); Tray benötigt AppIndicator-Erweiterung.
Ubuntu 26.04, GNOME Wayland Ungetestet Tray benötigt AppIndicator-Erweiterung; Whisper-Wheels können neuen Python-Versionen hinterherhinken.
Linux Mint 22.x, Cinnamon X11 Ungetestet xclip statt wl-copy als Clipboard-Backend; apt-ydotool 0.1.x → kein Auto-Paste.
Lubuntu 24.04 / 26.04, LXQt X11 / Wayland Ungetestet Session-Typ bestimmt das Clipboard-Backend – scripts/verify.sh zeigt, was gilt.

Diese Matrix stammt aus der Diagnose-Dokumentation des Projekts. Sie beschreibt erwartetes Verhalten und bekannte Risiken – sie ist keine Supportzusage.

Einschränkungen, die du kennen solltest

  • Auto-Paste benötigt ydotool ab Version 1.0. Ubuntu 24.04 und 22.04 liefern über apt nur 0.1.x – dort funktioniert die Zwischenablage, aber kein automatisches Einfügen (oder ydotool selbst kompilieren).
  • 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 Hauptfenster und 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 Blitztext+, Blitztext $%&! und Blitztext :), 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?

Systematisch getestet ist Kubuntu mit KDE Plasma unter Wayland. Ubuntu (GNOME), Linux Mint (Cinnamon) und Lubuntu (LXQt) teilen die Paketbasis und werden vom Installationsskript unterstützt, sind aber nicht systematisch getestet – die Kompatibilitätsmatrix oben ist eine Diagnose-Einordnung, keine Supportzusage.

Funktioniert Auto-Paste unter Wayland?

Ja, über ydotool ab Version 1.0 – auf der Referenzumgebung ist das verifiziert. Auf Systemen, deren Paketquellen nur ydotool 0.1.x liefern (z. B. Ubuntu 24.04/22.04 via apt), gibt es kein Auto-Paste; der Text liegt dann trotzdem in der Zwischenablage. Ein Selbstbau von ydotool ≥ 1.0 ist dokumentiert.

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