requirements-optional.txt

# SubFinder — optional dependencies
# subliminal and pywin32 are highly recommended (see below).
#
# Install everything at once:
#   pip install -r requirements-optional.txt
#
# Or pick only what you need.

# ── Windows — named pipe IPC ──────────────────────────────────────────────────
# Highly recommended on Windows. The primary way SubFinder talks to mpv —
# handles reading the currently playing file path and injecting subtitles
# directly into the player. Without this, auto-loading is disabled on Windows
# and SubFinder falls back to showing you a file path dialog instead.
#   pip install pywin32
pywin32; sys_platform == "win32"

# ── Subtitle provider (no API key required) ───────────────────────────────────
# Highly recommended. No account, no configuration — install it and you have
# a working subtitle source immediately. Used as a fallback when the direct
# OS.com API returns no results, and works entirely on its own if you have
# no API keys configured.
#   pip install subliminal babelfish dogpile.cache
subliminal
babelfish
dogpile.cache

# ── Subtitle format conversion ────────────────────────────────────────────────
# Required for:
#   - Translating ASS/SSA/VTT subtitles (Translate to menu)
#   - Stripping SDH annotations from non-SRT formats
#   pip install pysubs2
pysubs2

# ── Subtitle encoding detection ───────────────────────────────────────────────
# Fixes garbled characters in subtitle files that are not UTF-8 encoded.
# Already installed if you have the `requests` package.
#   pip install charset-normalizer
charset-normalizer
 
# ── Drag-and-drop ───────────────────────────────────
# Lets you drag a subtitle or archive file straight onto the SubFinder window
# to add it, instead of using the Add Subtitle File browse dialog. Purely a
# convenience — everything else works the same without it.
#   pip install tkinterdnd2
tkinterdnd2
 
# ── Subtitle/audio sync ───────────────────────────────────────────────────────
# Enables the Auto sync option in the right-click menu.
# Resource-intensive — use sparingly on long files.
# ffmpeg must also be installed and on your PATH (not a pip package).
#   pip install ffsubsync
ffsubsync