← Whispering

docs: Update README for v1.2.3 with file transcription features

e05c1a220204e15abb9b91e5b0cca6ae40e959ea · Claude · Jan 26, 2026 07:54

- Bump version to 1.2.3
- Add file transcription to key features section
- Add pydub to dependencies list
- Add changelog for v1.2.3 covering:
  - File transcription with time range selection
  - Native file dialog using PyQt6
  - Play/pause toggle with audio scrubbing
  - AI/TTS status indicators
  - MP3/M4A support via pydub fallback

+20 −1 · 1 file changed

  • README.md +20 −1
diff --git a/README.md b/README.md
index 75203ad..d816201 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Whispering 🎙️
 
-**Version 1.2**
+**Version 1.2.3**
 
 Real-time speech-to-text application with AI-powered translation, proofreading, and voice cloning.
 
@@ -10,6 +10,7 @@ Whispering combines [faster-whisper](https://github.com/SYSTRAN/faster-whisper)
 
 ###  Transcription & Translation
 - **Real-time Transcription**: Fast and accurate speech-to-text using Whisper models.
+- **File Transcription**: Transcribe audio files (MP3, WAV, FLAC, M4A, OGG) with time range selection.
 - **Live Translation**: Translate speech to 100+ languages instantly.
 - **Auto-Type**: Dictate directly into any application (Word, Browser, IDE, Discord).
 - **Smart Formatting**: Paragraph detection and automatic punctuation.
@@ -115,6 +116,7 @@ The core dependencies are installed automatically by `install.sh`, but include:
 - `faster-whisper`: Speech recognition engine.
 - `nicegui`: Modern web-based UI framework.
 - `sounddevice`: Low-level audio input.
+- `pydub`: MP3 and other audio format support.
 - `pywebview` & `PyQt6`: For running as a native desktop window.
 - `pyautogui`: For the Auto-Type feature.
 
@@ -139,6 +141,23 @@ Use `qpwgraph` for visual JACK-style audio routing.
 
 ## Changelog
 
+### Version 1.2.3
+**New Features:**
+- **File Transcription**: Transcribe audio files (MP3, WAV, FLAC, OGG, M4A, etc.)
+  - Single file, multiple files, or entire directory selection
+  - Native file dialog using PyQt6
+  - Time range selection (start/end time) for partial transcription
+  - Audio playback with play/pause toggle and position scrubbing
+  - Periodic auto-save during long file transcriptions
+  - Crash recovery support for file transcription sessions
+- **AI/TTS Status Indicators**: Visual indicators on the main panel showing when AI (green) or TTS (green) are enabled
+- **MP3/M4A Support**: Added pydub fallback for audio formats not supported by libsndfile
+
+**Improvements:**
+- Play button now toggles play/pause and updates playback position
+- File transcription uses dedicated queue to prevent result merging
+- Better error handling for unsupported audio formats
+
 ### Version 1.2
 **Improvements:**
 - Text output now persists when recording stops (clears only when new transcription starts)