Skip to content

aiden1020/localsubs

Repository files navigation


Logo

LocalSubs

Real-time, fully local AI subtitle translation for streaming video. Translates English subtitles to Traditional Chinese on-device using a fine-tuned 0.6B model — no data leaves your machine.

intro.mp4

Requirements

  • macOS (Apple Silicon or Intel)
  • Chrome / Chromium

Installation

brew tap aiden1020/localsubs
brew trust aiden1020/localsubs
brew install localsubs

localsubs model download   # ~424 MB, one-time
localsubs install           # connect to Chrome

brew trust is required because LocalSubs is distributed via a third-party tap. It authorizes Homebrew to install formulas from this tap on your machine.

Then install the LocalSubs Chrome extension and start watching.

Commands

Command Description
localsubs model download Download the translation model
localsubs install Connect to Chrome
localsubs status Check if the helper is running
localsubs doctor Run a full diagnostic
localsubs logs Print log file paths
localsubs version Print version

Model

Uses SubtitleEN2TW-0.6B, a fine-tuned GGUF model optimized for subtitle-length English → Traditional Chinese translation.

License

Apache 2.0 — see LICENSE.

About

Real-time, fully local AI subtitle translation for streaming video. Translates English subtitles to Traditional Chinese on-device using a fine-tuned 0.6B model

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors