/subsearch

Download subtitles for movies and shows, automatically with one easy mouse click.

Primary LanguagePythonMIT LicenseMIT

tests github_commit_activity python_version release downloads-total) license

Readme Table of Contents

FAQ Table of Contents

Misc Table of Contents

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

prtsc_example

Screenshots of the interface

prtsc_language

prtsc_search

prtsc_settings

prtsc_download

Installation and usage

Install from pypi:

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

Clone from github

  • 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.

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
Development builds can be located in the release action job, within the generated artifacts.
Screenshots of PUA message

prtsc_moreinfo

prtsc_runanyway


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

Acknowledgements

The following repositories provided templates, scripts, inspiration, themes, etc: