Subsearch 2.44.0

Subsearch

Readme Table of Contents

• About
• Preview of GUI
• Install from pypi
• Clone from github
• Install from MSI Package
• Acknowledgements

FAQ Table of Contents

• GUI Options Explained
• Code Analysis and False Positives
• Supported Languages

Misc Table of Contents

• Contributing
• Reporting a Vulnerability

About

Key Features

• Initiate a search for subtitles by simply right-clicking on a media file.
• Search for subtitles in 70 different languages
• Some of the subtitle filters are HI, non-HI, foreign parts only.
• User-friendly GUI for easy customization and configuration
• Available as a compiled executable, source code via GitHub and PyPI
• The setup process is straightforward.

Details

Subsearch is an automated subtitle downloader and extractor with support for many languages. It allows users to search and download subtitles for movies and TV shows with a single click from the context menu. The application features a graphical user interface for configuring options, such as selecting which websites to search on, choosing the subtitle language, applying filters for hearing-impaired, among other options.

Preview

Screenshots of the interface

Installation and usage

Install from pypi:

Requires Python 3.10+

• Install Subsearch by running pip install subsearch in the command prompt.
• Launch the app by running subsearch in the command prompt.

Clone from github

Requires Python *3.10+

• Clone the Subsearch repository by running git clone https://github.com/vagabondHustler/subsearch.git.
• Install Subsearch by running pip install -e . or *pip install -e .[build,lint,tests,tools,type] for optional dependencies.
• Build the executable and MSI installer by running python -m tools.cx_freeze_build bdist_msi.

[!IMPORTANT]

If you are using Python 3.12+ and cx_Freeze, please refer to this issue.

Windows installer

Requires windows 10/11, probably works on 8.

• Download the windows installer "Subsearch-x.x.x-win64.msi" from here.
• Run the installer.
• If you receive a PUA message, click "More info" → "Run anyway".
• Run Subsearch at least once for all the context menu options to appear

[!NOTE]

Development builds can be located in the release action job, within the generated artifacts.

Screenshots of PUA message

---

More about potentially unwanted applications (PUA) can be found here on Microsoft's support page.

Acknowledgements

I would like to express my gratitude to the following repositories for providing templates, scripts, inspiration, themes, and solutions to similar problems:

• zavoloklom/material-design-iconic-font // icons
• rdbende/Sun-Valley-ttk-theme // base theme
• TransparentLC // spritesheet_generator.js