docs: Update README for version 1.2

9c05b07833924bf283411f90de129a5d58f48a42 · Claude · Jan 26, 2026 06:08

- Add version number
- Add changelog section with v1.2 improvements and bug fixes
- Add section on capturing system audio with pw-loopback/pavucontrol

+35 · 1 file changed

README.md +35 −0

diff --git a/README.md b/README.md
index 0f2ce76..75203ad 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
 # Whispering 🎙️
 
+**Version 1.2**
+
 Real-time speech-to-text application with AI-powered translation, proofreading, and voice cloning.
 
 Whispering combines [faster-whisper](https://github.com/SYSTRAN/faster-whisper) for state-of-the-art speech recognition with modern AI models (Claude, GPT-4, Llama) to provide a powerful voice interface for your workflow.
@@ -116,6 +118,39 @@ The core dependencies are installed automatically by `install.sh`, but include:
 - `pywebview` & `PyQt6`: For running as a native desktop window.
 - `pyautogui`: For the Auto-Type feature.
 
+## Capturing System Audio
+
+To capture speaker/system audio output on Linux with PipeWire:
+
+**Option 1: pw-loopback (Recommended)**
+```bash
+# Run before starting Whispering:
+pw-loopback --capture-props='media.class=Audio/Sink' --playback-props='media.class=Audio/Source'
+```
+Then select "pipewire" as your input device in Whispering.
+
+**Option 2: pavucontrol**
+1. Start Whispering and begin recording with "pipewire" selected
+2. Open `pavucontrol` → Recording tab
+3. Change Whispering's input to "Monitor of [your speakers]"
+
+**Option 3: qpwgraph**
+Use `qpwgraph` for visual JACK-style audio routing.
+
+## Changelog
+
+### Version 1.2
+**Improvements:**
+- Text output now persists when recording stops (clears only when new transcription starts)
+- Crash recovery properly restores text into the UI window
+- Thread-safe clipboard operations prevent crashes during active transcription
+- Clean shutdown handling (Ctrl+C exits gracefully)
+- Simplified audio device selection
+
+**Bug Fixes:**
+- Fixed copy/cut crash when used during active transcription
+- Fixed log recovery not displaying recovered text in main window
+
 ##  License
 
 MIT License