{
    "info": {
        "author": "Brenner Heintz",
        "author_email": "brennerhdata@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "License :: OSI Approved :: MIT License",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3"
        ],
        "description": "# subtidal\n\n![GitHub](https://img.shields.io/github/license/athena15/subtidal.svg)\n[![python3](https://img.shields.io/badge/built%20with-Python%203-red.svg)](https://www.python.org/)\n\nA command line utility for **batch downloading subtitles for all movies organized in a central media folder.**\n\nWalks the file tree, visiting subfolders and downloading subtitles for each movie if they do not already exist.\n\nChanges subtitle names so that they are automatically recognized by Roku Media Player, VLC, and others.\n\nMakes quick work of central media folders and entire hard drives alike. Ideally, your central media folder will be organized as a repository of folders, with one movie or TV show each, but subtidal will still work if they're not quite that tidy.\n\n## Installation\n\nUse the package manager [pip](https://pip.pypa.io/en/stable/) to install subtidal. From the command line:\n\n```bash\npip install subtidal\n```\n\n## Quickstart\n***Option 1:** From the command line*\n\n```bash\ncd /path/to/Your-Movie-Folder\ndownload-subtitles\n```\nor, call `download-subtitles` and specify the path directly:\n```bash\ndownload-subtitles /path/to/your-movie-folder\n```\n\n***Option 2:** From Python*\n\n```python\nfrom subtidal.download import download\n\ndownload(\"./path/to/Your Movie Folder\")\n\n# you can also add optional parameters\ndownload(directory=\"./path/to/Your Movie Folder\", verbose=True)\n```\n\n![subtidal-demo](https://drive.google.com/uc?export=view&id=1MlJQrVGaocV80jZX5W7kYpjjH2xPWxDP)\n\n## Motivation\n\nI hope this project is of use to you. I got frustrated (or rather, was very mildly inconvenienced) because some of the movies I downloaded online didn't come included with subtitles, and I often found myself having to pause the movie I was watching to manually download them from sites like opensubtitles.org](https://opensubtitles.org).\n\nFurthermore, even when subtitles *were* included with a movie, if the filename differed at all from the name of the movie, they weren't recognized by the Roku Media Player, so I set about to rectify that.\n\nI have a huge, network-attached-storage media folder that acts as the central repository for all of the movies I download online, and I wanted to create a package that could download missing subtitles for every movie in it in one fell swoop.\n\nI imagined that as I downloaded new movies and TV shows into this central repository, I'd be able to run the package periodically via a cron job on my Raspberry Pi, so I'd never have to suffer the loathsome indignity of watching a show without having subtitles available ever again. This package is my attempt to make that vision a reality (or to make some fun out of laziness, depending on how you look at it), and in so doing, make a package available to the public on PyPI, which I had never done before.\n\n### Additional function & parameter info in the docstring\n\n```python\ndef download_subtitles(directory, verbose=False):\n    \"\"\"\n    Takes in a directory path, walks through the file tree, and downloads subtitles for any video files found.\n    Renames the subtitle file to match the video's name (in order to make it compatible with Roku Media Player.)\n\n    :param (str) directory: Directory where video files or folders are located.\n    :param (str) language : [optional] Desired language for subtitles, expressed as a 3-letter ISO-639-3 code. Visit https://bit.ly/29fjNpm for a list of language codes.\n    :param (str) country : [optional] Country code (needed in addition to language code for certain languages).\n    :param (bool) verbose : [optional] Prints more output to the console.\n\n    Examples:\n    1. download_subtitles('./Users/Laura/Movies')\n    2. download_subtitles(directory='./Users/Tim/TV Shows', verbose=True)\n    \"\"\"\n```\n\n\n## Contributing\nPull requests are welcome!\n\n## License\n[MIT](https://choosealicense.com/licenses/mit/)\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/athena15/subtidal",
        "keywords": "",
        "license": "",
        "maintainer": "",
        "maintainer_email": "",
        "name": "subtidal",
        "package_url": "https://pypi.org/project/subtidal/",
        "platform": "",
        "project_url": "https://pypi.org/project/subtidal/",
        "project_urls": {
            "Homepage": "https://github.com/athena15/subtidal"
        },
        "release_url": "https://pypi.org/project/subtidal/1.1.0/",
        "requires_dist": [
            "Click (>=7.0)",
            "pytest (>=4.4.1)",
            "subliminal (>=2.0.5)"
        ],
        "requires_python": "",
        "summary": "Subtidal, for batch downloading subtitles for all movies in a central media folder.",
        "version": "1.1.0"
    },
    "last_serial": 5236075,
    "releases": {
        "1.0.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "a9203b1e478d917685206364cdc4bcc5",
                    "sha256": "2f3a95b28bd404dadc927687d8b4dedc3ec8d8c491c47395f13e2f766c5d0a30"
                },
                "downloads": -1,
                "filename": "subtidal-1.0.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "a9203b1e478d917685206364cdc4bcc5",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 6436,
                "upload_time": "2019-04-24T01:50:15",
                "url": "https://files.pythonhosted.org/packages/57/26/8bb0b93895b4965d32ad662af3357e9b49182148a717189246ca83cef7f9/subtidal-1.0.0-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "45f444c9d1ccbf79798b1c74e8724105",
                    "sha256": "83914408b6866ed40b32f771c954157d05064421ff06c4dfea460e218198f3f6"
                },
                "downloads": -1,
                "filename": "subtidal-1.0.0.tar.gz",
                "has_sig": false,
                "md5_digest": "45f444c9d1ccbf79798b1c74e8724105",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 4575,
                "upload_time": "2019-04-24T01:50:17",
                "url": "https://files.pythonhosted.org/packages/92/e9/781eb82e35f7dde23a07a77ce17d8e6b43f7914ed4c4e3ec96785f008d92/subtidal-1.0.0.tar.gz"
            }
        ],
        "1.1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "50e510fa9c3d47e9c6a06bfe5defc128",
                    "sha256": "205a0e8c67b529cfbf4180aa9f1f45dda07bec47bcd2d101bca6d736a2f5f25d"
                },
                "downloads": -1,
                "filename": "subtidal-1.1.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "50e510fa9c3d47e9c6a06bfe5defc128",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 6520,
                "upload_time": "2019-05-07T04:45:04",
                "url": "https://files.pythonhosted.org/packages/eb/a2/66b99f8ef5250c0d9ee9636f8c48dfd58d5e4e9449c1eecf622aa8f0d6cd/subtidal-1.1.0-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "ba54eb872bdb8787728cf2d60fb55616",
                    "sha256": "54a2237afd4fe78b0c3c203c09caac59a1ec2a74a82f562ebc190fa407564bac"
                },
                "downloads": -1,
                "filename": "subtidal-1.1.0.tar.gz",
                "has_sig": false,
                "md5_digest": "ba54eb872bdb8787728cf2d60fb55616",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 4690,
                "upload_time": "2019-05-07T04:45:06",
                "url": "https://files.pythonhosted.org/packages/7b/04/12723048472ba0c3e1e45332202e887f5edea6ac433a47fbcea4a3ce2246/subtidal-1.1.0.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "50e510fa9c3d47e9c6a06bfe5defc128",
                "sha256": "205a0e8c67b529cfbf4180aa9f1f45dda07bec47bcd2d101bca6d736a2f5f25d"
            },
            "downloads": -1,
            "filename": "subtidal-1.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "50e510fa9c3d47e9c6a06bfe5defc128",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 6520,
            "upload_time": "2019-05-07T04:45:04",
            "url": "https://files.pythonhosted.org/packages/eb/a2/66b99f8ef5250c0d9ee9636f8c48dfd58d5e4e9449c1eecf622aa8f0d6cd/subtidal-1.1.0-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "ba54eb872bdb8787728cf2d60fb55616",
                "sha256": "54a2237afd4fe78b0c3c203c09caac59a1ec2a74a82f562ebc190fa407564bac"
            },
            "downloads": -1,
            "filename": "subtidal-1.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "ba54eb872bdb8787728cf2d60fb55616",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 4690,
            "upload_time": "2019-05-07T04:45:06",
            "url": "https://files.pythonhosted.org/packages/7b/04/12723048472ba0c3e1e45332202e887f5edea6ac433a47fbcea4a3ce2246/subtidal-1.1.0.tar.gz"
        }
    ]
}