Create README.md

README.md

@@ -1,14 +1,95 @@
 ---
-title: VideoSubtitles
-emoji: 📊
-colorFrom: indigo
-colorTo: green
+title: Video Subtitle Translator
+emoji: 🎬
+colorFrom: blue
+colorTo: purple
 sdk: gradio
-sdk_version: 5.32.0
+sdk_version: 4.44.0
 app_file: app.py
 pinned: false
 license: mit
-short_description: Subtitles
+hardware: cpu-basic
+short_description: VideoSubtitles
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🎬 Video Subtitle Translator
+
+A lightweight and powerful Hugging Face Space that generates and translates subtitles for any video file with **no size or duration limits**.
+
+## ✨ Features
+
+- **🎯 No Limits**: Process videos of any size or duration
+- **🌐 Multi-language Support**: Auto-detects 50+ languages and translates to English
+- **⚡ Lightweight Models**: Uses efficient Whisper Base and Helsinki translation models
+- **📱 Universal Compatibility**: Supports all video formats (MP4, AVI, MOV, MKV, etc.)
+- **🔧 Standard Output**: Generates SRT subtitle files compatible with all media players
+- **🚀 Fast Processing**: Optimized for speed while maintaining quality
+
+## 🛠️ How It Works
+
+1. **Upload** any video file
+2. **Choose** whether to translate to English or keep original language
+3. **Process** - the app will:
+   - Extract audio from your video
+   - Transcribe speech using Whisper
+   - Detect the source language automatically
+   - Translate to English (if requested)
+   - Generate downloadable SRT files
+
+## 🔧 Technical Details
+
+### Models Used
+- **Speech Recognition**: OpenAI Whisper Base (fast, lightweight)
+- **Translation**: Helsinki-NLP/opus-mt-mul-en (multilingual to English)
+- **Audio Processing**: FFmpeg for universal video format support
+
+### Key Optimizations
+- Lazy model loading to save memory
+- Chunked processing for long videos
+- Automatic GPU acceleration when available
+- Efficient audio extraction pipeline
+
+## 📋 Usage Instructions
+
+1. Click "Upload Video File" and select your video
+2. Choose "Yes" to translate to English, or "No" for transcription only
+3. Click "Generate Subtitles" and wait for processing
+4. Download the generated SRT files
+5. Use the subtitle files with any video player (VLC, Media Player, etc.)
+
+## 🌍 Supported Languages
+
+The app automatically detects and can translate from 50+ languages including:
+- Spanish, French, German, Italian, Portuguese
+- Chinese (Mandarin), Japanese, Korean
+- Arabic, Hindi, Russian, Turkish
+- And many more...
+
+## 🎯 Use Cases
+
+- **Content Creators**: Add subtitles to YouTube videos, tutorials, podcasts
+- **Educators**: Make educational content accessible in multiple languages
+- **Businesses**: Translate training videos, presentations, webinars
+- **Personal**: Add subtitles to family videos, travel vlogs
+- **Accessibility**: Make video content accessible to deaf/hard-of-hearing viewers
+
+## 🚀 Getting Started
+
+Simply upload your video and click "Generate Subtitles" - it's that easy!
+
+## 📝 Output Format
+
+The app generates standard SRT (SubRip) subtitle files that work with:
+- VLC Media Player
+- Windows Media Player
+- YouTube (for upload)
+- Streaming platforms
+- All major video editing software
+
+## 🤝 Contributing
+
+Feel free to suggest improvements or report issues!
+
+---
+
+*Built with ❤️ using Gradio, Whisper, and Transformers*