Quick Start
From installation to your first professional subtitle in 5 minutes
Welcome to MioSub! This guide will take you from installation to generating your first professional subtitle in under 5 minutes.
System Requirements
- Windows 10/11 (64-bit)
- macOS 12+ (Intel / Apple Silicon)
- Linux (x64 / arm64, AppImage)
- 4GB+ available RAM
- Internet connection (for API calls)
Step 1: Download & Install
Choose the right version for your system:
Detecting system...
- Windows Portable: Extract to any location (recommended:
D:\Apps\MioSub) and double-clickMioSub.exe - Windows Installer: Run the installer and follow the prompts
- macOS: Open DMG and drag to Applications folder
- Linux: Make executable and run:
chmod +x MioSub-*.AppImage && ./MioSub-*.AppImage
On first launch, MioSub will create configuration files automatically. Wait for the UI to load.
Step 2: Configure API Key
MioSub uses the Gemini API for intelligent translation. You'll need to configure your API key to get started.
Click the ⚙️ Settings button in the top-right corner
Find "Services" → "Gemini API Key" and enter your Gemini API Key
💡 Need a key? Get one free from Google AI Studio
Model Requirements
Ensure your API key has access to:
- Gemini 2.5/3 Flash (main translation)
- Gemini 3 Pro (glossary extraction)
Step 3: Generate Your First Subtitle
Now let's create your first professional subtitle!
Option A: Click "New Project", then "Upload Video/Audio" to select a local file
Option B: Click "One-Click Generate (Full Auto Mode)", paste a YouTube/Bilibili URL, and click Parse
- Target Language: Translation target (e.g., English)
- Type: What type of video is this? Presets are available for common types. Select "Custom" for more specific descriptions
- Glossary Extraction: Optional, enable in "Settings" → "Enhancement". Auto-extracts terminology from video/audio (no manual glossary upload needed!)
- Speaker Recognition: Optional, enable in "Settings" → "Enhancement". Distinguishes different speakers, ideal for interviews/radio shows
Click the "Start" button. MioSub will automatically:
- 🎵 Extract and denoise audio
- 🎙️ Transcribe with AI
- 📚 Extract smart glossary
- 🧠 Translate with context awareness
- ⚡ Align timestamps precisely
Once complete, use the editor to:
- Preview subtitles in real-time
- Edit translations
- Adjust timing
- Batch search & replace terminology or other issues
- Regenerate unsatisfactory segments
- Polish translations with AI
When satisfied, click "Export Subtitles..." or "Compress Video":
- SRT/ASS: Subtitle files only
- Video Compression: Hardcode subtitles into video
🎉 Congratulations!
You've successfully generated your first professional AI subtitle!
What's Next
- Local Whisper Setup - Offline transcription, faster and private
- Forced Alignment - Millisecond-precise timestamps
Need Help?
- 📖 Browse the full documentation
- 🐛 Submit an Issue