MioSub Docs
Guides

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-click MioSub.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:

  1. 🎵 Extract and denoise audio
  2. 🎙️ Transcribe with AI
  3. 📚 Extract smart glossary
  4. 🧠 Translate with context awareness
  5. ⚡ 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

Need Help?

On this page