Skip to main content

Subtitle Translator

Project description

Subtitle Translator

subtr is subtitle translator that translate a subtitle file eg: .srt using Google Cloud Translation API v3.

For now only .srt that supported

Getting Started

subtr using Cloud Translation API v3. It's Free, but requires you to create a service account and activate the billing to use it.

Try GCP Free Tier

Install subtr using pip

pip install subtr

Getting Google Cloud Service Account Key

Using Google Cloud SDK

Set Environment Variables


Enable Google Cloud Translation API

gcloud services enable

Create Service Account

gcloud iam service-accounts create ${SA_NAME}
    --display-name ${SA_DISPLAY_NAME}

Granting Roles to Service Account

gcloud projects add-iam-policy-binding ${PROJECT_ID} \
  --member serviceAccount:${SA_NAME}@${PROJECT_ID} \
  --role roles/cloudtranslate.admin
gcloud projects add-iam-policy-binding ${PROJECT_ID} \
  --member serviceAccount:${SA_NAME}@${PROJECT_ID} \
  --role roles/cloudtranslate.editor
gcloud projects add-iam-policy-binding ${PROJECT_ID} \
  --member serviceAccount:${SA_NAME}@${PROJECT_ID} \
  --role roles/cloudtranslate.user
gcloud projects add-iam-policy-binding ${PROJECT_ID} \
  --member serviceAccount:${SA_NAME}@${PROJECT_ID} \
  --role roles/cloudtranslate.viewer

Create Service Account Key

gcloud iam service-accounts keys create ${HOME}/.subtr-sa-key.json
  --iam-account ${SA_NAME}@${PROJECT_ID}

Using Google Cloud Console

See Cloud Translation Quickstart

How To Use

Set the environment variable. PROJECT_ID is your google cloud project id that associated with the service account that already created above. GOOGLE_APPLICATION_CREDENTIALS is file path of the JSON file that contains your service account key

export GOOGLE_APPLICATION_CREDENTIALS=${HOME}/.subtr-sa-key.json


subtr -h
usage: subtr [-h] -s SOURCE_LANG -t TARGET_LANG -f FILE_PATH

Subtitle translator.

optional arguments:
  -h, --help            show this help message and exit
  -s SOURCE_LANG, --source_lang SOURCE_LANG
                        Source language translate from.
  -t TARGET_LANG, --target_lang TARGET_LANG
                        Target language translate to.
  -f FILE_PATH, --file FILE_PATH
                        PATH to subtitle file.


subtr -s en-US -t id-ID -f sample/

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for subtr, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size subtr-0.0.5-py3-none-any.whl (5.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size subtr-0.0.5.tar.gz (3.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page