Voicext - Local AI Transcription Tool

Voicext is a high-performance desktop application built with Electron and React that provides local, private, and fast speech-to-text transcription. It leverages the power of GPU-accelerated AI to convert audio files into professional subtitle formats.

🚀 Features

Local Processing: Your data never leaves your machine. Privacy by design.
GPU Acceleration: Utilizes DirectCompute and CUDA for lightning-fast transcription using the Const-me Whisper implementation.
Smart SRT Fixing: Custom algorithm to ensure SRT files are 100% compatible with Adobe Premiere Pro and other NLEs.
Multi-format Output: Supports SRT, VTT, and TXT exports.
Modern UI: A sleek, responsive interface built with Tailwind CSS and Framer Motion.
Optimized for Turkish: Specialized handling for Turkish character encoding and language models.

🛠️ Technology Stack

Core: Electron
Frontend: React with Vite
Styling: Tailwind CSS & Framer Motion
Engine: Const-me/Whisper (Windows-optimized C++ implementation)
State Management: Zustand
Utilities: ffmpeg-static, iconv-lite, adm-zip

🧠 How It Works (Algorithm)

The transcription process follows a robust pipeline to ensure accuracy and compatibility:

Hardware Detection: The app automatically detects if an NVIDIA GPU is available to enable hardware acceleration.
Engine Initialization: It spawns a background process using the whisper.exe CLI, passing the audio file and selected model (e.g., base, small).
Stream Processing: Real-time feedback is captured from the engine's stdout/stderr, providing the user with live progress updates.
Post-Processing (SRT Fixer):
- Timestamp Normalization: Corrects overlapping or negative duration segments.
- Segment Merging: Automatically merges micro-segments that often occur in long-form audio.
- Encoding Correction: Ensures the output is UTF-8 encoded, specifically handling Turkish characters (CP857 conversion) to prevent "mojibake".
- NLE Compatibility: Formats the SRT specifically for high-end video editors like Adobe Premiere Pro.

⚙️ Setup & Installation

Prerequisites

Node.js (v18 or higher)
Git
NVIDIA GPU (Recommended for speed, but supports CPU)

Installation Steps

Clone the Repository:

git clone https://github.com/truncgil/voicext.git
cd voicext

Install Dependencies:
```
npm install
```
Download Binaries & Models: The application requires the Whisper executable and AI models. Run the automated setup script:
```
node scripts/setup-binaries.js
```
This will download the Const-me Whisper CLI and the ggml-base.bin model into the bin/ directory.
Run in Development Mode:
```
npm run dev
```
Build for Production:
```
npm run package
```

📂 Project Structure

src/main: Electron main process logic and transcription engine integration.
src/renderer: React-based UI components and state management.
bin/: (Generated) Contains whisper.exe and .bin models.
scripts/: Maintenance and setup scripts for binaries.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Developed with ❤️ by Voicext Team.

3.6 KiB Raw Blame History