Documentation v1.5.0

Overview

Qevoxyl is a desktop speech-to-text utility with a clean CustomTkinter UI. It records audio (or loads existing WAV/MP3), runs offline transcription using OpenAI Whisper, and can read the transcript aloud via optional Online TTS (cloud) or offline/system TTS when you keep Online TTS off.

Key Features

• Record / Transcribe — Capture mic audio or load a file and transcribe it offline.
• Offline models — Whisper models are cached locally per-user.
• TTS — Playback via Online TTS (cloud) when enabled, or offline TTS (system voice) when disabled.
• Context menu — Right-click a .wav/.mp3 → Transcribe with Qevoxyl.
• Installer — Inno Setup per-user installer (no admin/UAC).
• Logs — Persistent logs in %LOCALAPPDATA%\Qevoxyl\logs\app.log.

Building from Source

1) Prerequisites

• Python 3.13 (x64)
• Microsoft VC++ 2015–2022 Redistributable (x64)

2) Environment Setup

# Create venv (optional but recommended)
py -3.13 -m venv .venv
. .venv\Scripts\Activate

# Upgrade pip & install deps
python -m pip install -r requirements.txt

3) Build (PyInstaller, one-folder)

We ship one-folder (not one-file) to reduce AV heuristics and improve startup time.

# Build using the spec
python -m PyInstaller --clean .\app.spec

Packaging

Inno Setup Installer (per-user, no UAC)
Script: Qevoxyl.iss
Output: output\Qevoxyl-Setup-1.5.0.exe

Creates:

• Installs to %LOCALAPPDATA%\Qevoxyl
• Optional Desktop / Startup shortcuts.
• Explorer context menu integration for audio files.