Skip to content

v0.1.0 — OBS plugin (macOS, Windows, Linux)

Pre-release
Pre-release

Choose a tag to compare

View all tags
@Zeusxzx Zeusxzx released this 20 Aug 22:14
· 41 commits to main since this release
v0.1.0
f082950

Live translated captions captured inside OBS — no browser tab, no microphone permission, nothing running on your phone.

Full setup guide: https://streamtranslate.live/obs-plugin.html

macOS

Download StreamTranslate-OBS-Plugin.pkg below, then open it.

macOS will block it the first time ("Apple could not verify..."). The plugin isn't signed with an Apple Developer certificate yet, so Gatekeeper flags it. Two ways past it:

Option A — allow it in Settings (no Terminal)

  1. Double-click the .pkg and let it get blocked, then click Done
  2. Open System Settings → Privacy & Security
  3. Scroll to the bottom — you'll see "StreamTranslate-OBS-Plugin.pkg was blocked"
  4. Click Open Anyway, then run the installer again

(Note: on recent macOS versions, right-click → Open does not work for .pkg files. Use the steps above.)

Option B — one Terminal command

xattr -d com.apple.quarantine ~/Downloads/StreamTranslate-OBS-Plugin.pkg

Then double-click the .pkg normally.

The installer places the plugin in your user OBS plugins folder. Restart OBS afterwards.

Windows

Download StreamTranslate-OBS-Plugin-Windows.zip and extract it into your OBS folder — it drops the file into obs-plugins\64bit. Restart OBS.

Linux / Cloud OBS (IRLToolkit and similar)

Use obs-streamtranslate-linux.so, or build from source (see the README).

If your OBS runs on a cloud provider, you can't place files on their server yourself — message their support and ask them to install this plugin, linking this repository. It's open source and Linux-compatible, which is what they require. That's the only step you need them for; everything after is done from your own OBS remote.

Setting it up

  1. Filter (sends us your audio): right-click your mic or stream audio source → Filters → + → StreamTranslate → paste your Plugin Key from your StreamTranslate control page. It works like any audio filter and doesn't change your audio.
  2. Overlay (shows the captions): add your overlay URL as a Browser Source. Position and size it however you like.

Change languages any time from your control page — it applies live and never asks for microphone access. Muting the audio source in OBS pauses captions instantly.

Assets 5
Loading