Skip to main content

A tool to translate subtitles using Google Generative AI

Project description

Gemini SRT Translator

PyPI version Python support Downloads

Overview

Gemini SRT Translator is a tool designed to translate subtitle files using Google Generative AI. It leverages the power of the Gemini API to provide accurate and efficient translations for your subtitle files.

Features

  • Translate subtitle files to a specified target language.
  • Customize translation settings such as model name and batch size.
  • List available models from the Gemini API.

Installation

To install Gemini SRT Translator, use pip:

pip install gemini-srt-translator

Setup

Generating Your API Key

To use Gemini SRT Translator, you need to generate a free API key from Google AI Studio. Follow these steps:

  1. Go to Google AI Studio API Key.
  2. Sign in with your Google account.
  3. Click on "Generate API Key".
  4. Copy the generated API key and keep it secure.

You will use this API key for setting up the script before starting the translation process.

Usage

Translate Subtitles

You can translate subtitles using the translate command:

import gemini_srt_translator as gst

gst.gemini_api_key = "your_gemini_api_key_here"
gst.target_language = "French"
gst.input_file = "subtitle.srt"

gst.translate()

This will translate the subtitles in the subtitle.srt file to French.

Configuration

You can further customize the translation settings by providing optional parameters:

  • output_file: Path to save the translated subtitle file.
  • model_name: Model name to use for translation.
  • batch_size: Batch size for translation.

Example:

import gemini_srt_translator as gst

gst.gemini_api_key = "your_gemini_api_key_here"
gst.target_language = "French"
gst.input_file = "subtitle.srt"
gst.output_file = "subtitle_translated.srt"
gst.model_name = "gemini-1.5-flash"
gst.batch_size = 30

gst.translate()

List Models

You can list the available models using the listmodels command:

import gemini_srt_translator as gst

gst.gemini_api_key = "your_gemini_api_key_here"
gst.listmodels()

This will print a list of available models to the console.

License

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

Project details


Download files

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

Source Distribution

gemini_srt_translator-1.2.0.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

gemini_srt_translator-1.2.0-py3-none-any.whl (6.6 kB view details)

Uploaded Python 3

File details

Details for the file gemini_srt_translator-1.2.0.tar.gz.

File metadata

  • Download URL: gemini_srt_translator-1.2.0.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.5

File hashes

Hashes for gemini_srt_translator-1.2.0.tar.gz
Algorithm Hash digest
SHA256 ea4ad27e8cd97b6f279c8dce6d6b239edb38974e9234cdce6afff2edb9907f95
MD5 b7fbb2141993e6a7fb3f636c028b4442
BLAKE2b-256 60c50dcf7436df151daf3464b3c4a0cc536d8f4e7de7ef12dbedc110123191a8

See more details on using hashes here.

File details

Details for the file gemini_srt_translator-1.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for gemini_srt_translator-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d4a224fd6bdf58114127ab1b1f629e70282415eb8a0080ef21004a180a14da53
MD5 87a525dfd4465d67d7e4d2fdeeb47780
BLAKE2b-256 12b4ce78997e5e3d6353317e05f86e5af7abcd817eec693604b941e071962411

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page