Auto-subtitle a folder on your computer.

Install the subsrip CLI, point it at a folder, and new video files get an English .srt sidecar within minutes. Works on macOS, Linux, and Windows.

Install

curl -fsSL https://www.subs.rip/install.sh | sh

Requires ffmpeg on PATH — brew install ffmpeg.

Quickstart

  1. 1

    Log in on your machine

    subsrip login

    Sign in to get a one-click install command.

  2. 2

    Point it at a folder

    subsrip add ~/Movies --lang en --match all

    Everything already in the folder gets scanned; new files are picked up automatically when subsrip watch is running.

  3. 3

    Start the watcher

    subsrip watch

    Runs in the foreground. Up to three files in flight at once. Ctrl+C to stop.

Keep it running

subsrip watch stops when you close the terminal. For a persistent watcher, wire it into your OS's service manager. A subsrip install-service command is planned — until then, these snippets work.

macOS — launchd+

Save as ~/Library/LaunchAgents/rip.subs.watcher.plist, then launchctl load it:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>              <string>rip.subs.watcher</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/subsrip</string>
    <string>watch</string>
  </array>
  <key>RunAtLoad</key>          <true/>
  <key>KeepAlive</key>          <true/>
  <key>StandardOutPath</key>    <string>/tmp/subsrip.log</string>
  <key>StandardErrorPath</key>  <string>/tmp/subsrip.err.log</string>
</dict>
</plist>
launchctl load ~/Library/LaunchAgents/rip.subs.watcher.plist
Linux — systemd (user service)+

Save as ~/.config/systemd/user/subsrip.service, then enable it:

[Unit]
Description=subsrip watcher

[Service]
ExecStart=/usr/local/bin/subsrip watch
Restart=on-failure

[Install]
WantedBy=default.target
systemctl --user enable --now subsrip.service
Windows — Task Scheduler+

Create a task that runs at logon:

schtasks /create /sc onlogon /tn "subsrip watcher" ^
  /tr "%LOCALAPPDATA%\subsrip\bin\subsrip.exe watch"

FAQ

How do I update?+
Re-run the install one-liner. It's idempotent and replaces the binary in place. The CLI also checks for new versions once a day and prints a short nudge when you're behind.
How do I uninstall?+
macOS / Linux: rm $(which subsrip). Windows: delete %LOCALAPPDATA%\subsrip\bin\subsrip.exe. The CLI keeps a small config folder at ~/.config/subsrip (or %APPDATA%\subsrip) — remove that too if you want a clean slate.
"subsrip: command not found" after install+
Your shell hasn't picked up the new PATH yet. Open a new terminal, or source ~/.zshrc / source ~/.bashrc. On Windows, sign out and back in.
Does it work offline?+
No — transcription runs on subs.rip. The CLI only handles audio extraction, upload, and writing the .srt sidecar next to your file.
How much does it cost?+
Same credits as the web app. Free accounts get 5 lifetime translations; Pro is $10/month for 10/month with rollover. The CLI never spends credits on files already in the public library. See pricing.
Is the source available?+
Yes — the CLI source lives in the subs.rip repo's cli/ directory. The install script and binaries are served from this site directly.

Something broken? Open an issue.