Getting started

Install SubMate in Chrome

The recommended installation method is the official Chrome Web Store listing. GitHub Releases and local builds remain available for manual testing and development.

Requirements

SubMate targets desktop Google Chrome 138 or newer on macOS, Windows, and Linux. You need an active subscription to the service you are watching and a title with a text subtitle track.

Install from the Chrome Web Store

  1. Open the official SubMate Chrome Web Store listing.
  2. Select Add to Chrome and confirm the installation.
  3. Pin SubMate, open a supported title, choose a target language, and start translation.

Chrome Web Store installs receive published updates through Chrome automatically.

Install a release manually

  1. Download the latest ZIP from GitHub Releases.
  2. Extract the ZIP to a permanent local folder.
  3. Open chrome://extensions and enable Developer mode.
  4. Select Load unpacked and choose the extracted folder containing manifest.json.
  5. Pin SubMate, open a supported title, choose a target language, and start translation.

The release ZIP contains extension files at its root. Extract it before selecting Load unpacked; do not choose the ZIP itself.

Install a local build

Clone the repository, run npm ci followed by npm run build:chrome, then choose the generated dist/chrome/ folder in Chrome.