<h1 align="center"><img src="https://raw.githubusercontent.com/vagabondHustler/SubSearch/main/assets/subsearch_v2.png"/></h1>
<div align="center">
</div>
#### Readme Table of Contents
- [About](#about)
- [Preview of GUI](#preview)
- [Install from pypi](#pypi)
- [Clone from github](#clone)
- [Install from MSI Package](#msi)
- [Acknowledgements](#thanks)
#### FAQ Table of Contents
- [GUI Options Explained](https://github.com/vagabondHustler/subsearch/discussions/556)
- [Code Analysis and False Positives](https://github.com/vagabondHustler/subsearch/discussions/557)
- [Supported Languages](https://github.com/vagabondHustler/subsearch/discussions/558)
#### Misc Table of Contents
- [Contributing](https://github.com/vagabondHustler/SubSearch/blob/main/.github/CONTRIBUTING.md)
- [Reporting a Vulnerability](https://github.com/vagabondHustler/SubSearch/blob/main/.github/SECURITY.md)
## About <a name = "about"></a>
#### 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](https://github.com/vagabondHustler/subsearch/discussions/558). 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](https://github.com/vagabondHustler/subsearch/discussions/556).
## Preview <a name = "preview"></a>
<div align="center">
<details>
<summary>Screenshots of the interface</summary>
</details>
</div>
## Installation and usage <a name = "getting_started_src"></a>
#### Install from pypi: <a name = "pypi"></a>
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 <a name = "clone"></a>
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](https://github.com/marcelotduarte/cx_Freeze/issues/2153).
#### Windows installer <a name = "msi"></a>
Requires windows 10/11, probably works on 8.
- Download the windows installer "Subsearch-x.x.x-win64.msi" from [here](https://github.com/vagabondHustler/subsearch/releases).
- 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](https://github.com/vagabondHustler/subsearch/actions/workflows/release.yml) action job, within the generated artifacts.
<details>
<summary>Screenshots of PUA message<a name = "pua"></a></summary>
---
</details>
More about potentially unwanted applications (PUA) can be found [here](https://support.microsoft.com/en-us/windows/protect-your-pc-from-potentially-unwanted-applications-c7668a25-174e-3b78-0191-faf0607f7a6e) on Microsoft's support page.
## Acknowledgements<a name = "thanks"></a>
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](https://github.com/zavoloklom/material-design-iconic-font) // icons
- [rdbende/Sun-Valley-ttk-theme](https://github.com/rdbende/Sun-Valley-ttk-theme) // base theme
- [TransparentLC](https://github.com/TransparentLC) // spritesheet_generator.js
Raw data
{
"_id": null,
"home_page": "",
"name": "Subsearch",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "",
"keywords": "subtitles,sub,srt,tool,tools,download,movies,shows,scrape,opensubtitles,subscene,subsearch,subtitles,yifysubtitles",
"author": "vagabondHustler",
"author_email": "vagabondHustler.github@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/59/c4/b82ea7919074c57d7e929bf2ebc7ecf345e9883f8aed3d3b9051462d9767/Subsearch-2.44.0.tar.gz",
"platform": "win32",
"description": "<h1 align=\"center\"><img src=\"https://raw.githubusercontent.com/vagabondHustler/SubSearch/main/assets/subsearch_v2.png\"/></h1>\r\n\r\n<div align=\"center\">\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n</div>\r\n\r\n#### Readme Table of Contents\r\n\r\n- [About](#about)\r\n- [Preview of GUI](#preview)\r\n- [Install from pypi](#pypi)\r\n- [Clone from github](#clone)\r\n- [Install from MSI Package](#msi)\r\n- [Acknowledgements](#thanks)\r\n\r\n#### FAQ Table of Contents\r\n\r\n- [GUI Options Explained](https://github.com/vagabondHustler/subsearch/discussions/556)\r\n- [Code Analysis and False Positives](https://github.com/vagabondHustler/subsearch/discussions/557)\r\n- [Supported Languages](https://github.com/vagabondHustler/subsearch/discussions/558)\r\n\r\n#### Misc Table of Contents\r\n\r\n- [Contributing](https://github.com/vagabondHustler/SubSearch/blob/main/.github/CONTRIBUTING.md)\r\n- [Reporting a Vulnerability](https://github.com/vagabondHustler/SubSearch/blob/main/.github/SECURITY.md)\r\n\r\n## About <a name = \"about\"></a>\r\n\r\n#### Key Features\r\n \r\n- Initiate a search for subtitles by simply right-clicking on a media file.\r\n- Search for subtitles in 70 different languages\r\n- Some of the subtitle filters are HI, non-HI, foreign parts only.\r\n- User-friendly GUI for easy customization and configuration\r\n- Available as a compiled executable, source code via GitHub and PyPI\r\n- The setup process is straightforward.\r\n\r\n#### Details\r\n\r\nSubsearch is an automated subtitle downloader and extractor with support for many [languages](https://github.com/vagabondHustler/subsearch/discussions/558). 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](https://github.com/vagabondHustler/subsearch/discussions/556).\r\n\r\n## Preview <a name = \"preview\"></a>\r\n\r\n<div align=\"center\">\r\n\r\n\r\n\r\n<details>\r\n<summary>Screenshots of the interface</summary>\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n</details>\r\n\r\n</div>\r\n\r\n## Installation and usage <a name = \"getting_started_src\"></a>\r\n\r\n#### Install from pypi: <a name = \"pypi\"></a>\r\n\r\nRequires Python 3.10+\r\n\r\n- Install Subsearch by running `pip install subsearch` in the command prompt.\r\n- Launch the app by running `subsearch` in the command prompt.\r\n\r\n#### Clone from github <a name = \"clone\"></a>\r\n\r\nRequires Python *3.10+\r\n\r\n- Clone the Subsearch repository by running `git clone https://github.com/vagabondHustler/subsearch.git`.\r\n- Install Subsearch by running `pip install -e .` or *`pip install -e .[build,lint,tests,tools,type]` for optional dependencies.\r\n- Build the executable and MSI installer by running `python -m tools.cx_freeze_build bdist_msi`.\r\n\r\n> [!IMPORTANT] \r\n> ###### If you are using Python 3.12+ and cx_Freeze, please refer to [this issue](https://github.com/marcelotduarte/cx_Freeze/issues/2153).\r\n\r\n#### Windows installer <a name = \"msi\"></a>\r\n\r\nRequires windows 10/11, probably works on 8.\r\n\r\n- Download the windows installer \"Subsearch-x.x.x-win64.msi\" from [here](https://github.com/vagabondHustler/subsearch/releases).\r\n- Run the installer.\r\n- If you receive a PUA message, click \"More info\" \u2192 \"Run anyway\".\r\n- Run Subsearch at least once for all the context menu options to appear\r\n\r\n> [!NOTE] \r\n> ###### Development builds can be located in the [release](https://github.com/vagabondHustler/subsearch/actions/workflows/release.yml) action job, within the generated artifacts.\r\n\r\n<details>\r\n<summary>Screenshots of PUA message<a name = \"pua\"></a></summary>\r\n\r\n\r\n\r\n\r\n\r\n---\r\n\r\n</details>\r\n\r\nMore about potentially unwanted applications (PUA) can be found [here](https://support.microsoft.com/en-us/windows/protect-your-pc-from-potentially-unwanted-applications-c7668a25-174e-3b78-0191-faf0607f7a6e) on Microsoft's support page.\r\n\r\n## Acknowledgements<a name = \"thanks\"></a>\r\n\r\nI would like to express my gratitude to the following repositories for providing templates, scripts, inspiration, themes, and solutions to similar problems:\r\n\r\n- [zavoloklom/material-design-iconic-font](https://github.com/zavoloklom/material-design-iconic-font) // icons\r\n- [rdbende/Sun-Valley-ttk-theme](https://github.com/rdbende/Sun-Valley-ttk-theme) // base theme\r\n- [TransparentLC](https://github.com/TransparentLC) // spritesheet_generator.js\r\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "Subsearch",
"version": "2.44.0",
"project_urls": {
"repository": "https://github.com/vagabondHustler/subsearch"
},
"split_keywords": [
"subtitles",
"sub",
"srt",
"tool",
"tools",
"download",
"movies",
"shows",
"scrape",
"opensubtitles",
"subscene",
"subsearch",
"subtitles",
"yifysubtitles"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1fcf2b9832acfdea1d454bbd69f14c48336324434fff853c152b771886a55681",
"md5": "0c93bab76130be6dbe28fab8ef2ad4fa",
"sha256": "8f40c84d8f8e419c81555df6aa91eb4fd53752d7b66b14d416fbebb72288f3ad"
},
"downloads": -1,
"filename": "Subsearch-2.44.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0c93bab76130be6dbe28fab8ef2ad4fa",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 70816,
"upload_time": "2024-01-28T20:47:08",
"upload_time_iso_8601": "2024-01-28T20:47:08.592047Z",
"url": "https://files.pythonhosted.org/packages/1f/cf/2b9832acfdea1d454bbd69f14c48336324434fff853c152b771886a55681/Subsearch-2.44.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "59c4b82ea7919074c57d7e929bf2ebc7ecf345e9883f8aed3d3b9051462d9767",
"md5": "fdcf5ad520d6f839e0a9c9c9d4fa9e5d",
"sha256": "22613f66a36299a56e440eda4be78c6fc4e1b0d485dcbbb2ed77b9e7ce1f10b1"
},
"downloads": -1,
"filename": "Subsearch-2.44.0.tar.gz",
"has_sig": false,
"md5_digest": "fdcf5ad520d6f839e0a9c9c9d4fa9e5d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 60083,
"upload_time": "2024-01-28T20:47:14",
"upload_time_iso_8601": "2024-01-28T20:47:14.390879Z",
"url": "https://files.pythonhosted.org/packages/59/c4/b82ea7919074c57d7e929bf2ebc7ecf345e9883f8aed3d3b9051462d9767/Subsearch-2.44.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-28 20:47:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "vagabondHustler",
"github_project": "subsearch",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "subsearch"
}
JSON
