Subsearch is a Windows subtitle downloader with File Explorer integration, a PySide6 desktop UI, and a Subtitle Workspace for searching, reviewing, downloading, and post-processing subtitles.
Use it as a quiet right-click workflow, a fully manual download manager, or a mix of both. Subsearch tries to download the best match automatically and opens the workspace only when you need to choose one yourself.
Highlights
- Right-click video files in File Explorer, drag files into the app, or search by title from the workspace
- Manual, hybrid, and automatic search modes
- Providers: OpenSubtitles, YIFY Subtitles, Subsource, TVsubtitles, and Gestdown
- 115 subtitle languages, with provider compatibility handled for each language
- Movie and TV matching with IMDb title suggestions and season and episode selection
- Adjustable filename scoring for title, source, release group, year, season/episode, and edition mismatches
- Filters for hearing-impaired, non-HI, and foreign-parts-only subtitles
- Post-processing to extract, rename, and move the best subtitle or every downloaded subtitle
- Configurable download, extraction, and destination paths, including relative paths next to the video
- Windows notifications, system tray support, single-instance mode, update checks, crash logs, and provider diagnostics
- Available as a Windows MSI installer, a PyPI package, or a source install
Preview
Installation
Windows installer
Requires Windows 10 or 11. It may also work on Windows 8.
- Download the installer from the releases page.
- Run the installer. If a SmartScreen or PUA warning appears, select More info, then Run anyway. (More information)
- Launch Subsearch once to register its File Explorer context-menu entries.
PUA warning screenshots
Install from PyPI
pip install subsearch
subsearch
Clone from GitHub
git clone https://github.com/vagabondHustler/subsearch.git
cd subsearch
pip install -e .
To install the optional development dependencies, run:
pip install -e .[build,lint,tests,tools,type]
Build the MSI with cx_Freeze:
python .github/workflows/scripts/jobs.py make_msi
License
- Subsearch is licensed under the GNU General Public License v3.0 or later. See
LICENSEfor the full text. - Third-party notices are listed in
THIRD-PARTY-LICENSES.md.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file subsearch-3.1.0.tar.gz.
File metadata
- Download URL: subsearch-3.1.0.tar.gz
- Upload date:
- Size: 160.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e6ca9e922156033bedf9617ac3d50de545d102ce73beeb9b94b23f5aba293083
|
|
| MD5 |
efd92db633e03f7b17065be3caed6728
|
|
| BLAKE2b-256 |
57ffe975ecf568a8e989205b1da785021cbdb348b57ed6bb14a7b8a9b46567f9
|
File details
Details for the file subsearch-3.1.0-py3-none-any.whl.
File metadata
- Download URL: subsearch-3.1.0-py3-none-any.whl
- Upload date:
- Size: 214.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bc467e07dfeb0b027ca9a3b4e037eb27a9ff09340637c1e49b18a3d090923c74
|
|
| MD5 |
a7b304cb51fc4016f2df1c130b9b3997
|
|
| BLAKE2b-256 |
885e101b811e7cfb035e32b53d97c29fdb0f06d04ce04f72ef345dff518a837f
|
