Skip to content
Subtide

Quick Start

Quick Start

Section titled “Quick Start”

Get Subtide running in under 5 minutes.

1. Start the Backend

Section titled “1. Start the Backend”

Choose one of the following options:

=== “Binary (Recommended)”

Download the latest backend binary from Releases:

  • subtide-backend-linux
  • subtide-backend-macos
  • subtide-backend-windows.exe

!!! note “Prerequisite” FFmpeg must be installed.

Terminal window
# Make executable (Linux/macOS)
chmod +x subtide-backend-macos


# Run
./subtide-backend-macos

=== “Python Source”

Terminal window
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
./run.sh

=== “Docker”

Terminal window
cd backend
docker-compose up subtide-tier2

The backend will start on http://localhost:5001.

2. Install the Extension

Section titled “2. Install the Extension”

=== “Chrome / Edge / Brave”

  1. Download subtide-extension.zip from Releases
  2. Extract the ZIP file
  3. Open Chrome → chrome://extensions
  4. Enable Developer mode (top right)
  5. Click Load unpacked → select the extracted folder
  6. Pin the extension to your toolbar

=== “Firefox”

  1. Download subtide-extension-firefox.zip from Releases
  2. Open Firefox → about:debugging
  3. Click This Firefox → Load Temporary Add-on
  4. Select the ZIP file

3. Configure

Section titled “3. Configure”
  1. Click the Subtide extension icon in your toolbar
  2. Select your operation mode (Tier 1 for basic usage)
  3. Enter your API key and select a model (for Tier 1 & 2)
  4. Choose your target language
  5. Click Save

Tip: API Providers

4. Translate!

Section titled “4. Translate!”

YouTube Videos

Section titled “YouTube Videos”
  1. Go to any YouTube video
  2. Click the translate button in the player controls (bottom right)
  3. Subtitles appear automatically

YouTube Shorts

Section titled “YouTube Shorts”
  1. Navigate to any Shorts video
  2. Click the floating translate button (bottom-right of the video)
  3. Enable translation - videos are pre-translated as you scroll
  4. Subtitles appear instantly when swiping to the next Short

Next Steps

Section titled “Next Steps”