-
+
Blitztext Linux
Your local AI voice assistant for Linux desktops on Wayland
@@ -38,7 +38,7 @@ Blitztext Linux is a hotkey-driven voice assistant that turns speech into text a
## Features
- **Multilingual interface (EN/DE):** Switch the app interface between German and English under **Settings → General → "Interface language"** (takes effect after restarting the app).
-- **Compose window:** Type or paste any text, select a workflow and writing style, and let the AI rewrite it — no microphone needed. Includes tone selector, custom preset, variant history, and signature support.
+- **Compose window:** Type, paste, or dictate any text, pick a text action, and let the AI rewrite it — no microphone needed. Includes tone selector, custom instruction with prompt inspection, variant navigation, and signature support.
- **OpenRouter & custom LLM endpoints:** Use OpenRouter or any OpenAI-compatible API as an alternative to OpenAI for all AI workflows.
- **Audio export:** Save read-aloud output as an audio file directly from the Read Aloud window.
- **Custom names / terms:** Extend the AI's vocabulary with your own terms, names, or technical words for perfect transcriptions.
@@ -53,21 +53,21 @@ Blitztext registers global hotkeys via `evdev`. With these combinations you have
| Workflow | Hotkey | LLM? | Description |
| :--- | :--- | :---: | :--- |
-| **Blitztext** |
Alt (hold) | ❌ | Default: records while the key is held, transcribes, and pastes the text. Very short presses below 150 ms are discarded as accidental taps in hold mode. Recording key and hold/toggle mode are configurable under **Settings → Speech Recognition**. |
-| **Blitztext Local** |
Meta +
Shift +
H | ❌ | Forces a pure **offline transcription**. |
-| **Blitztext+** |
Meta +
Shift +
T | ✅ | Rephrases your recording professionally via LLM. |
-| **Blitztext $%&!** |
Meta +
Shift +
D | ✅ | Emotional release: turns frustration into a matter-of-fact message. |
-| **Blitztext :)** |
Meta +
Shift +
E | ✅ | Enriches your message with fitting emojis. |
+| **Dictate** |
Alt (hold) | ❌ | Default: records while the key is held, transcribes, and pastes the text. Very short presses below 150 ms are discarded as accidental taps in hold mode. Recording key and hold/toggle mode are configurable under **Settings → Speech Recognition**. |
+| **Dictate · local** |
Meta +
Shift +
H | ❌ | Forces a pure **offline transcription**. |
+| **Dictate & improve** |
Meta +
Shift +
T | ✅ | Transcribes and rewrites the result with the selected text action. |
+| **Make it factual** |
Meta +
Shift +
D | ✅ | Emotional release: turns frustration into a matter-of-fact message. |
+| **Add emojis** |
Meta +
Shift +
E | ✅ | Enriches your message with fitting emojis. |
> [!NOTE]
-> **LLM workflows** (`Blitztext+`, `Blitztext $%&!`, `Blitztext :)`) require a valid **API key**. See [Secrets](#secrets) below for how to configure it. Without a key, these functions are disabled in the menu and via hotkeys, or result in an error message.
+> **LLM workflows** (`Dictate & improve`, `Make it factual`, `Add emojis`) require a valid **API key**. See [Secrets](#secrets) below for how to configure it. Without a key, these functions are disabled in the menu and via hotkeys, or result in an error message.
### AI workflows
-The AI workflows help with phrasing, tone, and emojis. You'll find the relevant settings under **Settings → AI Workflows**:
+The AI workflows help with phrasing, tone, and emojis. You'll find the relevant settings under **Settings → Text & AI**:
-
+
@@ -80,7 +80,7 @@ The AI workflows help with phrasing, tone, and emojis. You'll find the relevant
> and the systemd user service load that file on the next start. See
> [Secrets](#secrets) for the complete file format and permission instructions.
-**LLM providers.** Blitztext supports three provider modes, selectable under **Settings → AI Workflows → "LLM provider"**:
+**LLM providers.** Blitztext supports three provider modes, selectable under **Settings → Text & AI → "LLM provider"**:
| Provider | When to use |
| :--- | :--- |
@@ -90,50 +90,55 @@ The AI workflows help with phrasing, tone, and emojis. You'll find the relevant
For OpenRouter, set `base_url` to `https://openrouter.ai/api/v1` and choose your model (e.g. `openai/gpt-4o`). The API key environment variable name is configured under "API key environment".
-**Writing-style presets.** For the **Blitztext+** workflow (text improver) there are ready-made writing-style presets that you select under **Settings → AI Workflows → "Writing-style preset"** or directly in the **Compose window**:
+**Text actions.** Rewriting is built around five clearly separated actions. You select them under **Settings → Text & AI → "Text action"**, in the Compose window, or in the ⋯ menu of the main widget:
-| Preset | Effect |
+| Text action | Effect |
| --- | --- |
-| **Standard (improve text)** | Previous behavior – cleanly formatted text, the selected **tone** applies. |
-| **Email – formal** | Polite email in the formal form with a clear structure. |
-| **Email – casual** | Friendly email in the informal form. |
-| **Bullet points** | Structures the content into concise bullet points. |
-| **Summary** | Concise, factual summary of the key statements. |
-| **Personal (informal)** | Clear text in a personal, informal tone. |
-| **Polite (formal)** | Clear text in a polite, formal tone. |
-| **Short & precise** | As concise as possible, without filler words and repetitions. |
-| **Custom preset…** | A free-form system prompt you define yourself under **Settings → General → "Custom preset (Compose)"**. |
-
-> With **Standard**, the configured **tone** (casual / neutral / professional) is additionally applied. Every other preset brings its own writing style and overrides the tone setting. Custom names/terms are preserved in all presets.
+| **Improve text** | Default: cleanly formatted text with corrected grammar and punctuation; the selected **target tone** applies. |
+| **Shorten** | Removes filler words, repetitions, and detours while keeping every essential piece of information. |
+| **Expand** | Turns notes and fragments into coherent prose — without adding new facts. |
+| **Change tone** | Changes the tone only (casual / neutral / professional) and leaves content, language, and intent untouched. |
+| **Custom instruction** | Your own instruction from the Compose window ("How should your text sound?"). **Save & use for dictation** also applies it to the Dictate & improve workflow. |
+
+> The **target tone** applies to **Improve text** and **Change tone**. Older configurations with the previous nine writing-style presets are migrated automatically to the closest action (e.g. "Email – formal" → **Change tone**, professional). Custom names/terms are preserved in every action.
### Compose window
-The **Compose window** (`✍ Compose…` in the tray menu) lets you rewrite any text using the AI — without recording your voice. It is ideal for editing existing drafts, emails, or notes.
+The **Compose window** (`✍ Edit text…` in the tray menu or the pen button in the main widget) lets you draft, rewrite, and refine text using the AI — without recording your voice. It is ideal for polishing emails, notes, or messages before pasting them anywhere.
-
+
-**How to open:** Click the tray icon → **✍ Compose…**
+**How to open:** Click the tray icon → **✍ Edit text…** or click the gold pen button in the main window widget.
**What you can do in the Compose window:**
| Element | Description |
| :--- | :--- |
-| **Draft (left pane)** | Type or paste the text you want to rewrite. |
-| **Workflow** | Choose between Blitztext+ (text improver), Blitztext $%&! (steam release), or Blitztext :) (emojis). |
-| **Writing-style preset** | Select a preset or **Custom preset…** for a fully custom system prompt. |
-| **Tone** | Choose casual, neutral, or professional. Active only when **Standard** preset + **Blitztext+** is selected; grayed out for all other presets (a tooltip explains why). |
-| **Improve** | Sends your draft to the AI and shows the result in the right pane. |
-| **Variant history** | The last 10 generated results within the current session are kept as a scrollable list — click any entry to restore it. |
-| **Signature** | Appends your saved signature (configured under **Settings → General**). Automatically replaces common AI-generated placeholders such as `[Your Name]`, `[Ihr Name]`, `[Vorname Nachname]`, `[Signature]`, and similar — so no stray placeholder is ever left behind. |
-| **Copy** | Copies the result to the clipboard. |
-| **Insert & Close** | Pastes the result directly into the active application and closes the window. |
+| **Text action selector** | Choose between *Improve text*, *Shorten*, *Expand*, *Change tone*, or *Custom instruction*. |
+| **Tone selector** | Appears dynamically when *Change tone* is selected (Casual, Neutral, Professional). |
+| **Custom instruction …** | Expands an inline prompt editor (*"How should your text sound?"*). **Improve** uses this instruction for the current draft; **Save & use for dictation** persists it for future sessions and selects it for dictation workflows. |
+| **Inspect prompt** | Inspect the exact system prompt and instructions before submitting to the LLM. |
+| **Route voice input here** | When checked, active voice dictations are inserted directly into the draft field instead of being pasted to the active application. |
+| **Draft (left pane)** | Type, paste, or dictate the text you want to rewrite. |
+| **Result (right pane)** | Shows the AI-generated output side by side with your draft. |
+| **Variant navigation** | The results generated in this session stay available — step through them with the ‹ › arrows above the result pane. |
+| **Copy** | Copies the generated result to the clipboard. |
+| **Insert & Close** | Pastes the result directly into the active application and closes the compose window. |
+
+
+
+
+
+
Inspect and edit the LLM instruction directly inside the Compose window.
+
+
> [!NOTE]
-> The signature and custom preset text are configured under **Settings → General**. Set "Signature for Compose window" and toggle "Automatically append after generation" if you want the signature added to every result.
+> Signature and custom preset text are configured under **Settings → General**. Set "Compose Window Signature" and toggle "Auto-append after generation" if you want your signature automatically added to every result. Common AI placeholders (like `[Your Name]`) are cleanly replaced.
### Tray icon and context menu
@@ -166,35 +171,61 @@ The microphone in the system tray is your indicator of the current state:
+ 
+ 
+ 
+ 
- 
+ 
- 
+ 
- 
+ 
