Demo GIF with real UI, Breeze-Dark screenshots, and correct default hotkey label (#52)

* docs(readme): add animated workflow demo GIF with generator script

Add a deterministic demo GIF generator (scripts/_make_demo_gif.py)
that grabs the real PyQt6 main window offscreen — with the real
Breeze-Dark theme applied like at app startup — in its true states
(ready, recording, transcribing, done) and composites it next to a
plain target text field that receives the transcript. The real tray
icons mirror the workflow states; no invented controls are drawn.

The displayed hotkey matches the actual default configuration:
hold left Alt (transcription_hotkey: KEY_LEFTALT, hotkey_mode: hold).

Embed the generated demo-en.gif / demo-de.gif at the top of both
READMEs and cover the pure helpers with unit tests.

* fix(tray): show the real default recording key instead of Meta+H

The standard Blitztext workflow is triggered by the configurable
recording key (transcription_hotkey, default KEY_LEFTALT in hold
mode) — there is no Meta+H mapping in the hotkey service. The tray
menu and WORKFLOW_META nevertheless displayed a hardcoded Meta+H.

Derive the tray menu label from the actual configuration via a new
hotkey_display_name() helper (covers all VALID_HOTKEY_KEYS), fix the
hotkey table in both READMEs, and adjust the workflow metadata.

* fix(screenshots): render README assets with the real Breeze-Dark theme

The screenshot generator never called theme.apply_theme(), so all
committed README screenshots and banners showed the unthemed light
Qt look instead of the actual Breeze-Dark glass appearance the app
applies at startup. Apply the theme like the real app start does and
regenerate every screenshot and banner (the tray menu now also shows
the corrected Alt hotkey label).

Author: TimInTech

README.de.md

@@ -18,6 +18,12 @@
   <p><strong>🔗 Webseite: <a href="https://timintech.github.io/blitztextweb/">timintech.github.io/blitztextweb</a></strong></p>
 </div>
 
+<div align="center">
+  <img src="docs/screenshots/linux/demo-de.gif" alt="Demo: Hotkey drücken, sprechen, und Blitztext fügt den transkribierten Text direkt in die aktive Anwendung ein" width="720">
+  <br>
+  <sub><kbd>Alt</kbd> gedrückt halten (Standard-Hotkey), sprechen, loslassen — das Transkript landet direkt in der aktiven Anwendung.</sub>
+</div>
+
 > [!IMPORTANT]
 > **Eigenständiger Linux-Port:** Dieses Repository enthält ausschließlich den Linux-Port von Blitztext – eine eigenständige Python 3/PyQt6-Implementierung optimiert für **Kubuntu/Ubuntu unter KDE Plasma mit Wayland**. Für die originale macOS-Version besuche bitte das [offizielle Haupt-Repository](https://github.com/cmagnussen/blitztext-app).
 
@@ -47,7 +53,7 @@ Blitztext registriert globale Hotkeys via `evdev`. Mit diesen Kombinationen hast
 
 | Workflow | Hotkey | LLM? | Beschreibung |
 | :--- | :--- | :---: | :--- |
-| **Blitztext** | <kbd>Meta</kbd> + <kbd>H</kbd> | ❌ | Standard: Nimmt auf, transkribiert und fügt den Text ein. |
+| **Blitztext** | <kbd>Alt</kbd> (halten) | ❌ | Standard: Nimmt auf, solange die Taste gehalten wird, transkribiert und fügt den Text ein. Aufnahmetaste und Halten/Umschalten-Modus sind unter **Einstellungen → Spracherkennung** konfigurierbar. |
 | **Blitztext Lokal** | <kbd>Meta</kbd> + <kbd>Shift</kbd> + <kbd>H</kbd> | ❌ | Erzwingt eine reine **Offline-Transkription**. |
 | **Blitztext+** | <kbd>Meta</kbd> + <kbd>Shift</kbd> + <kbd>T</kbd> | ✅ | Formuliert deine Aufnahme professionell via LLM um. |
 | **Blitztext $%&!** | <kbd>Meta</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> | ✅ | Emotionale Entladung: Wandelt Frust in eine sachliche Nachricht um. |

README.md

@@ -18,6 +18,12 @@
   <p><strong>🔗 Website: <a href="https://timintech.github.io/blitztextweb/">timintech.github.io/blitztextweb</a></strong></p>
 </div>
 
+<div align="center">
+  <img src="docs/screenshots/linux/demo-en.gif" alt="Demo: press the hotkey, speak, and Blitztext pastes the transcribed text into the active application" width="720">
+  <br>
+  <sub>Hold <kbd>Alt</kbd> (default hotkey), speak, release — the transcript lands directly in the active application.</sub>
+</div>
+
 > [!IMPORTANT]
 > **Standalone Linux port:** This repository contains exclusively the Linux port of Blitztext – a standalone Python 3/PyQt6 implementation optimized for **Kubuntu/Ubuntu running KDE Plasma with Wayland**. For the original macOS version, please visit the [official main repository](https://github.com/cmagnussen/blitztext-app).
 
@@ -47,7 +53,7 @@ Blitztext registers global hotkeys via `evdev`. With these combinations you have
 
 | Workflow | Hotkey | LLM? | Description |
 | :--- | :--- | :---: | :--- |
-| **Blitztext** | <kbd>Meta</kbd> + <kbd>H</kbd> | ❌ | Default: records, transcribes, and pastes the text. |
+| **Blitztext** | <kbd>Alt</kbd> (hold) | ❌ | Default: records while the key is held, transcribes, and pastes the text. Recording key and hold/toggle mode are configurable under **Settings → Speech Recognition**. |
 | **Blitztext Local** | <kbd>Meta</kbd> + <kbd>Shift</kbd> + <kbd>H</kbd> | ❌ | Forces a pure **offline transcription**. |
 | **Blitztext+** | <kbd>Meta</kbd> + <kbd>Shift</kbd> + <kbd>T</kbd> | ✅ | Rephrases your recording professionally via LLM. |
 | **Blitztext $%&!** | <kbd>Meta</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> | ✅ | Emotional release: turns frustration into a matter-of-fact message. |

app/blitztext_linux.py

@@ -33,7 +33,7 @@
 from app.config import Config, DEFAULTS, VALID_HOTKEY_KEYS
 from app.llm_service import LLMService, WorkflowType, LLM_WORKFLOWS
 from app.writing_presets import WRITING_PRESET_KEYS, get_preset, preset_index
-from app.hotkey_service import HotkeyWorker
+from app.hotkey_service import HotkeyWorker, hotkey_display_name
 from app.audio_recorder import AudioRecorder, AudioRecorderError
 from app.transcribe import transcribe, TranscribeError
 from app.paste_service import PasteService, PasteServiceError
@@ -705,7 +705,9 @@ def setup_tray(self) -> None:
         self.menu.addSeparator()
 
         # Actions für die fünf Workflows
-        self.action_transcription = QAction(f"{t('workflow.transcription.name')}\tMeta+H", self)
+        self.action_transcription = QAction(
+            f"{t('workflow.transcription.name')}\t{hotkey_display_name(self.config.transcription_hotkey)}", self
+        )
         self.action_transcription.triggered.connect(lambda: self._trigger_menu_workflow(WorkflowType.TRANSCRIPTION))
         self.menu.addAction(self.action_transcription)
 
@@ -816,7 +818,9 @@ def _refresh_i18n_texts(self) -> None:
         if hasattr(self, "action_compose"):
             self.action_compose.setText(f"✍  {t('tray.compose')}")
         if hasattr(self, "action_transcription"):
-            self.action_transcription.setText(f"{t('workflow.transcription.name')}\tMeta+H")
+            self.action_transcription.setText(
+                f"{t('workflow.transcription.name')}\t{hotkey_display_name(self.config.transcription_hotkey)}"
+            )
         if hasattr(self, "action_local"):
             self.action_local.setText(f"{t('workflow.local.name')}\tMeta+Shift+H")
         if hasattr(self, "action_improver"):

app/hotkey_service.py

@@ -21,6 +21,29 @@
 DEVICE_REFRESH_SECONDS = 5.0
 logger = logging.getLogger("blitztext.hotkey")
 
+# Anzeigenamen für die konfigurierbare Aufnahmetaste (config.transcription_hotkey).
+# Deckt alle VALID_HOTKEY_KEYS aus app/config.py ab; unbekannte Namen fallen
+# auf den evdev-Namen ohne "KEY_"-Präfix zurück.
+_HOTKEY_DISPLAY_NAMES = {
+    "KEY_LEFTALT": "Alt",
+    "KEY_RIGHTALT": "AltGr",
+    "KEY_LEFTCTRL": "Ctrl",
+    "KEY_RIGHTCTRL": "Ctrl",
+    "KEY_F13": "F13",
+    "KEY_F14": "F14",
+    "KEY_F15": "F15",
+    "KEY_F16": "F16",
+    "KEY_SCROLLLOCK": "Scroll Lock",
+    "KEY_PAUSE": "Pause",
+    "KEY_INSERT": "Insert",
+    "KEY_CAPSLOCK": "Caps Lock",
+}
+
+
+def hotkey_display_name(key_name: str) -> str:
+    """Menschenlesbarer Name der Aufnahmetaste für Menü- und UI-Labels."""
+    return _HOTKEY_DISPLAY_NAMES.get(key_name, key_name.removeprefix("KEY_").capitalize())
+
 # Hotkey-Definitionen: WorkflowType -> (modifier_set, trigger_key_name)
 _HOTKEY_MAP = [
     # (workflow, trigger_key, required_modifiers)

app/workflows.py

@@ -12,7 +12,10 @@ class WorkflowType(str, Enum):
 WORKFLOW_META: Dict[WorkflowType, Dict[str, Any]] = {
     WorkflowType.TRANSCRIPTION: {
         "display_name": "🎙  Blitztext",
-        "hotkey": "Meta+H",
+        # Standard-Aufnahmetaste (config.transcription_hotkey: KEY_LEFTALT);
+        # der tatsächliche Wert ist konfigurierbar, UI-Labels leiten ihn zur
+        # Laufzeit über hotkey_service.hotkey_display_name() ab.
+        "hotkey": "Alt",
         "needs_llm": False,
         "description": "Standard Sprache zu Text (Online oder Lokal)",
     },