Subtitle Mode

Subtitle Mode

Subtitle mode allows you to generate AI-powered subtitles using Whisper, download subtitles from multiple providers, and manage subtitle tracks in your video files. Supports automatic subtitle generation, batch subtitle downloading, and subtitle embedding for videos.

Overview

Subtitle mode provides:

• ✅ AI-powered subtitle generation (OpenAI Whisper - 90+ languages)
• ✅ Download from 9+ subtitle providers
• ✅ Anime-specific providers (Kitsunekko, Jimaku, AnimeSubtitles)
• ✅ Multiple languages per file
• ✅ Three output modes (external, embedded, burn-in)
• ✅ Automatic subtitle scoring and selection

Quick Start

1. Select Subtitle Mode from the sidebar (📝 icon)
2. Add Files containing videos that need subtitles
3. Select Languages you want subtitles for
4. Choose Provider (Whisper AI or web providers)
5. Click Process to search/generate
6. Select Best Subtitles for each language
7. Apply to Files with your preferred output mode

Subtitle Providers

AI Generation (Whisper)

Setup Required: Download Whisper models (Tools → Setup AI Subtitles)

Supported Languages: 90+ languages including:

• English, Spanish, French, German, Italian, Portuguese
• Japanese, Chinese, Korean, Hindi, Thai, Vietnamese
• Russian, Arabic, Turkish, Polish, Dutch, Swedish, Norwegian
• And many more!

Models:

• tiny - Fastest, least accurate (~39 MB)
• base - Balanced (~74 MB)
• small - Good accuracy (~244 MB)
• medium - High accuracy (~769 MB)
• large - Best accuracy (~3 GB)

Use When:

• No subtitles available online
• High accuracy needed
• Multiple languages
• Custom content

Web Providers

Paid/Account Required

OpenSubtitles (✅ Currently Working)

• Largest database
• Requires API key (free available)
• 5/day free, 20/day with account, 200/day VIP
• Movies, TV shows, anime

Free Providers (🔄 Currently Broken)

General Content:

• Addic7ed - TV shows and movies
• SubDL - Movies and TV shows
• Subf2m - Movies and TV shows
• YIFY - Movies only
• Podnapisi - Multilingual content
• SubDivX - Spanish subtitles

Anime-Specific:

• Kitsunekko - Japanese and English anime subtitles
• Jimaku - Multiple languages for anime
• AnimeSubtitles - Multiple languages for anime

Note: Most web scraping providers are currently not working due to website changes. Only OpenSubtitles (API) is functional.

Interface Overview

Quick Settings Panel

Provider Selection:

• Dropdown to select subtitle provider
• Tooltip shows available providers
• Whisper AI shows model status

Language Selection:

• Multi-select checkboxes for languages
• Flag icons for visual identification
• Search multiple languages simultaneously

Selected Files Count:

• Shows number of files ready for processing

Main Content Area

Subtitle Preview Section

Available Subtitles Table:

• Select multiple subtitles per language
• Score-based ranking
• Provider information
• Format information

Subtitle Details:

• Shows details for selected subtitle
• File format
• Language code
• Matching score

Output Mode Selection

External (.srt file):

• Save subtitle file next to video
• Fastest (no video processing)
• Compatible with all players
• No quality loss

Embed (Track):

• Add subtitle as track inside video
• Fast (no re-encoding)
• Keeps video in one file
• Compatible with most players

Burn-in (Hardcoded):

• Permanently overlay subtitles
• Slow (re-encodes video)
• Always visible
• Cannot be disabled

Processing

Auto-Select Best

Automatically selects the highest-scored subtitle for each language.

Apply to File

Applies selected subtitles to the currently selected file.

Batch Apply All

Applies selected subtitles to ALL files in the queue that have results.

Setup Providers

Whisper AI Setup

1. Go to Tools → Setup AI Subtitles
2. Follow the wizard
3. Download model(s)
4. Models stored in: settings/whisper-models/

System Requirements:

• 4GB RAM minimum
• 8GB RAM recommended for large model
• Optional GPU acceleration

OpenSubtitles Setup

1. Get API key from opensubtitles.com
2. Open Settings
3. Go to Subtitle Providers tab
4. Enter API key
5. Save settings

Account Types:

• Free - 5 downloads/day
• Account - 20 downloads/day
• VIP - 200 downloads/day

Usage Examples

Example 1: Generate English Subtitles

1. Add video file
2. Select "Whisper AI" provider
3. Check "🇬🇧 English"
4. Click "Process"
5. Wait for generation
6. Select generated subtitle
7. Choose "External" output mode
8. Click "Apply to File"

Example 2: Download Spanish Subtitles

1. Add video file
2. Select "OpenSubtitles" provider
3. Check "🇪🇸 Spanish (EU)"
4. Click "Process"
5. Review available subtitles
6. Select best match
7. Choose "Embed" output mode
8. Click "Apply to File"

Example 3: Multiple Languages

1. Add video file
2. Select "Whisper AI" provider
3. Check multiple languages (English, Spanish, French)
4. Click "Process"
5. Wait for all languages to generate
6. Click "Auto-Select Best"
7. Choose "Embed" output mode
8. Click "Batch Apply All"

Subtitle Scoring

EncodeForge uses intelligent scoring to rank subtitles:

Scoring Factors:

• Filename similarity (40%)
• Release group match (20%)
• Language match (20%)
• Provider reputation (10%)
• User ratings (10%)

Higher scores = better matches

Troubleshooting

Common Issues

Issue: "Whisper not setup"

• Solution: Go to Tools → Setup AI Subtitles

Issue: "No subtitles found"

• Check: File exists and is readable
• Check: Provider is properly configured
• Solution: Try different provider

Issue: "OpenSubtitles API error"

• Check: API key is valid
• Check: Rate limit not exceeded
• Solution: Wait or upgrade account

Issue: Subtitles out of sync

• Cause: Subtitle file timing mismatch
• Solution: Use Whisper for accurate timing

Issue: Low accuracy (Whisper)

• Cause: Poor audio quality
• Solution: Use larger model or better audio source

Performance Tips

For Speed:

• Use "tiny" or "base" Whisper model
• Process fewer languages at once
• Use external output mode

For Accuracy:

• Use "medium" or "large" Whisper model
• Ensure good audio quality
• Use GPU acceleration if available

Advanced Features

Batch Processing

Process entire libraries:

1. Add folder with videos
2. Select languages
3. Click "Process"
4. Review all results
5. Auto-select best matches
6. Batch apply to all files

Preview Subtitles

Review subtitles before applying:

• Click subtitle in results table
• View details and format
• Check language and provider
• Verify scores

Custom Subtitle Handling

• Extract existing subtitles
• Convert between formats
• Merge multiple languages
• Adjust timing

Keyboard Shortcuts

• Ctrl+F - Focus search/language
• Enter - Apply selected subtitles
• Ctrl+A - Select all
• Ctrl+D - Deselect all

Tips & Tricks

1. Auto-Select First - Use auto-select to get best matches quickly
2. Multiple Providers - Try different providers for best results
3. Batch Process - Process entire folders efficiently
4. Embed Subtitles - Keep videos and subtitles together
5. Whisper for Accuracy - Use Whisper when web providers fail

Related Pages

• Getting Started
• Encoder Mode
• Metadata Mode
• Settings & Configuration
• Support

---

Ready to add subtitles? Add your files and select your languages!