Transcriber 0.1.4

A simple tool to transcribe audio files

Transcriber

A flexible Python package for transcribing audio and video from various sources (SoundCloud, YouTube, or local files) into multiple text formats (txt, docx, srt). The transcriber supports multiple speech recognition models (defaulting to Whisper "large-v3"). It leverages GPU acceleration for faster processing and utilizes concurrency through async and multiprocessing to improve performance.

Features

• Multiple Input Sources: Transcribe from SoundCloud, YouTube, or local audio/video files
• Multiple Models: Support for both faster-whisper and standard whisper models
• GPU Acceleration: Utilize GPU processing for faster transcription
• Concurrent Processing: Batch processing and VAD filtering for improved performance
• Various Output Formats: Export transcriptions to multiple formats
• Progress Tracking: Rich progress bars showing transcription status
• Configurable: Extensive configuration options via environment variables or settings

Requirements

• Python 3.11 or higher
• GPU support (optional but recommended for better performance)

Installation

1. Install the package:

   uv pip install Transcriber
   

Configuration

1. Copy the example environment file:

   cp .env.example .env
   

2. Configure the settings in .env:

   # Input settings
   INPUT__URLS_OR_PATHS=["Audio_To_Transcribe"]
   INPUT__SKIP_IF_OUTPUT_EXIST=false
   
   # Output settings
   OUTPUT__OUTPUT_FORMATS=["all"]
   OUTPUT__OUTPUT_DIR="Transcripts"
   
   # Whisper model settings
   WHISPER__LANGUAGE="ar"
   

Usage

Basic Usage

from Transcriber.transcriber import transcribe

# Configure input files in .env, then:
transcribe()

Command Line Usage

uv run --with Transcriber transcribe

Example Configuration

# Example settings in your .env file
INPUT__URLS_OR_PATHS=["path/to/audio.mp3", "https://youtube.com/watch?v=example"]
OUTPUT__OUTPUT_FORMATS=["txt", "srt"]
WHISPER__LANGUAGE="en"

Acknowledgments

• OpenAI Whisper
• Faster Whisper