Skip to content

Repository files navigation

🌐 Zee Subtitle Translator

A command-line tool for batch translating subtitle files with support for multiple engines and formats.

Python Version License Platform

Features

  • Multiple translation engines: Google Translate (free), DeepL API, and ChatGPT API
  • Batch processing for multiple files and folders
  • Interactive file browser with multi-folder selection
  • Automatic text cleaning (removes tags like [MUSIC], (SOUND), etc.)
  • Custom credits option for translated subtitles
  • Real-time progress tracking and detailed reports
  • Support for SRT, VTT, and ASS subtitle formats
  • Smart encoding detection and proper name preservation
  • Three speed modes: Safe, Standard, and Aggressive
  • Bilingual interface (English and Indonesian)
  • Global command - run from anywhere

Requirements

  • Python 3.7 or higher (auto-installed if not present on Windows)
  • Internet connection for downloading and translation

Documentation


Platform-Specific Notes

Linux

  • Tested on Ubuntu, Debian, Arch, Fedora
  • Requires curl or wget and unzip
  • Global command works in bash and zsh

macOS

  • Works on Intel and Apple Silicon
  • Requires Homebrew for easy Python installation
  • Use python3 command

Windows

  • Windows 10/11 recommended
  • PowerShell gives best experience
  • Command Prompt also supported
  • Python auto-installs if missing

Android (Termux)

  • Must use F-Droid or GitHub version
  • Google Play Store version is broken
  • Install to Shared Storage for file manager access
  • Widget support for quick launch
  • Storage shortcuts created automatically

Acknowledgments


Links


Screenshots

Screenshot at 2025-11-11 15-52-56 Screenshot at 2025-11-11 15-58-22

⭐ Star this repo if you find it helpful

Releases

Sponsor this project

Packages

Contributors

Languages