Hugging Face's logo

Spaces:
Maaz1
/
LinguaStream
Running

App Files Community
LinguaStream / README.md
Maaz1's picture
Maaz1
Update README.md
e3ab549 verified
preview code
|
raw
history blame contribute delete
2.5 kB

A newer version of the Gradio SDK is available: 5.27.1

Upgrade
metadata
title: LinguaStream
sdk: gradio
emoji: 🌍
colorFrom: yellow
colorTo: purple
pinned: true
short_description: 'A Multilingual Audio and Video dubbing tool. '
sdk_version: 5.25.2

Video Translator 🌐

A complete video translation system that converts videos into multiple languages by translating both subtitles and audio.

Features

  • 🎬 Video to text transcription using AssemblyAI
  • 🔤 Translation of transcripts to multiple languages
  • 🔊 Text-to-speech generation in target languages
  • 📝 Subtitle generation and embedding
  • 🎞️ Final video with translated audio and subtitles

Supported Languages

  • English
  • Spanish
  • French
  • German
  • Japanese
  • Hindi
  • And more...

Installation

  1. Clone this repository:
git clone https://github.com/Maaz1/LinguaStream.git
cd LinguaStream
  1. Install dependencies:
pip install -r requirements.txt

  1. Install FFmpeg:

    • On Ubuntu/Debian: sudo apt-get install ffmpeg
    • On macOS (with Homebrew): brew install ffmpeg
    • On Windows: Download from FFmpeg website

  2. Set up your API key:

    • Copy .env.example to .env
    • Add your AssemblyAI API key to the .env file (to get audio text)

Usage

  1. Run the app:
python app.py
  1. Open the provided URL in your browser
  2. Upload a video file
  3. Select source and target languages
  4. Click "Translate" and wait for processing

Deployment on Hugging Face Spaces

This project is configured for easy deployment to Hugging Face Spaces. To deploy:

  1. Fork this repository
  2. Create a new Space on Hugging Face
  3. Connect your GitHub repository
  4. Set the required environment variables (ASSEMBLYAI_API_KEY)
  5. Deploy!

Project Structure 

video-translator/
├── app.py                    # Main Gradio app entry point
├── config.py                 # Configuration and constants
├── src/                      # Source code
│   ├── audio/                # Audio processing
│   ├── video/                # Video processing
│   ├── subtitles/            # Subtitle handling
│   └── utils/                # Utilities and helpers
└── outputs/                  # Output directory

Environment Variables

  • ASSEMBLYAI_API_KEY: API key for AssemblyAI (required)
  • DEBUG: Set to "True" for debug logging (optional)
  • OUTPUT_DIR: Custom output directory path (optional)

License

MIT License