andersonchale/swahili-subtitle-translator

Swahili Subtitle Translator # 🎬 Swahili Subtitle Translator A professional, open-source tool for translating subtitle files from English to Swahili. Perfect for content creators, translators, and media enthusiasts who want to make English content accessible to Swahili speakers. ## ✨ Features - **🌍 Multiple Translation Services**: Google Translate and MyMemory support with automatic fallback - **📁 Multiple Subtitle Formats**: SRT, ASS/SSA, VTT, and SUB format support - **⚡ Smart Caching**: SQLite-based translation cache to reduce API calls and improve speed - **🔄 Batch Processing**: Translate entire directories of subtitle files - **🎯 Cultural Adaptation**: Built-in Swahili cultural context and common phrase translations - **🛡️ Robust Error Handling**: Automatic retry mechanism and graceful failure handling - **📊 Progress Tracking**: Real-time progress bars and detailed statistics - **🎨 Beautiful CLI**: Colorized command-line interface with professional output - **🔧 Highly Configurable**: Extensive customization options and settings ## 🚀 Quick Start ### Method 1: Global Installation (Recommended) **🎯 One-Command Installation:** ```bash # Clone the repository git clone github.com cd swahili-subtitle-translator # Run the automated installation script chmod +x install_global.sh ./install_global.sh ``` This script will: - Detect your operating system (Linux/macOS/Windows Git Bash) - Offer installation options (system-wide, user, virtual environment, or pipx) - Handle modern Python restrictions (PEP 668 externally-managed environments) - Make `sst` and `swahili-sub-translate` commands globally available - Test the installation automatically **🌐 Manual Global Installation:** ```bash # Method A: pipx (recommended for modern Python - handles PEP 668) sudo apt install pipx # Ubuntu/Debian # brew install pipx # macOS pipx install /path/to/swahili-subtitle-translator # Method B: User installation (no admin rights needed) pip3 install …