Skip to content

Voice Transcriber v0.2.0 — confident microphone setup

Choose a tag to compare

@OthmaneBlial OthmaneBlial released this 26 Aug 17:19
· 42 commits to main since this release

Voice Transcriber v0.2.0 makes the first recording session easier to trust: choose the right microphone, see its local signal respond, then dictate.

Highlights

  • Choose the system default or a detected microphone from Settings; the choice is saved locally for future sessions.
  • Verify a live, rate-limited input meter before dictation. The meter is derived locally from in-memory PCM and never records audio.
  • Inspect machines without opening GTK using python main.py --list-devices or JSON output with --list-devices --json.
  • Override the saved microphone for one run with python main.py --device INDEX.
  • Keep real-time behavior bounded: native input discovery is released immediately, capture queues remain capped, and unavailable saved inputs are shown clearly instead of silently changing source.

Quick start

git clone https://github.com/OthmaneBlial/audio-capture.git
cd audio-capture
./setup.sh
cp .env.example .env
# add a newly created GROQ_API_KEY to .env
source venv/bin/activate
python main.py --check-config
python main.py --list-devices
python main.py

Privacy and support boundary

Raw microphone frames and the input meter stay in process memory. After local voice activity detection, completed speech segments are sent to Groq for transcription. This is a Debian/Ubuntu GTK 3 desktop application, not an offline transcription engine.

Validation

  • 15 unit tests passed, including faked native input discovery, selection, cleanup, and signal normalization.
  • Ruff, Python compilation, package build, static-site syntax, local HTTP, copy interaction, mobile overflow, and console checks passed.
  • CI passed on the tagged commit with actions/checkout@v7 and actions/setup-python@v7.

Project site · Documentation · Changelog · Security policy