Metadata-Version: 2.1
Name: pytube
Version: 10.7.0
Summary: Python 3 library for downloading YouTube Videos.
Home-page: https://github.com/nficano/pytube
Author: Nick Ficano, Harold Martin
Author-email: nficano@gmail.com, harold.martin@gmail.com
License: MIT
Project-URL: Bug Reports, https://github.com/nficano/pytube/issues
Project-URL: Read the Docs, https://python-pytube.readthedocs.io/en/latest
Description: 
        <div align="center">
          <p>
            <a href="#"><img src="https://assets.nickficano.com/gh-pytube.min.svg" width="456" height="143" alt="pytube logo" /></a>
          </p>
          <p align="center">
        	<a href="https://pypi.org/project/pytube/"><img src="https://img.shields.io/pypi/dm/pytube?style=flat-square" alt="pypi"/></a>
        	<a href="https://python-pytube.readthedocs.io/en/latest/"><img src="https://readthedocs.org/projects/python-pytube/badge/?version=latest&style=flat-square" /></a>
            <a href="https://codecov.io/gh/pytube/pytube" aria-label="coverage"><img src="https://img.shields.io/codecov/c/github/pytube/pytube?style=flat-square" /></a>
        	<a href="https://pypi.org/project/pytube/"><img src="https://img.shields.io/pypi/v/pytube?style=flat-square" /></a>
          </p>
        </div>
        
        ### Actively soliciting contributers!
        
        Have ideas for how pytube can be improved? Feel free to open an issue or a pull
        request!
        
        # pytube
        
        *pytube* is a very serious, lightweight, dependency-free Python library (and
        command-line utility) for downloading YouTube Videos.
        
        ## Documentation
        
        Detailed documentation about how to use the library can be found on our
        [readthedocs](https://python-pytube.readthedocs.io) page. This is recommended
        for most use cases. If you just want to quickly download a single video,
        the [quickstart](#Quickstart) guide below might be what you're looking for.
        
        ## Description
        
        YouTube is the most popular video-sharing platform in the world and as a hacker
        you may encounter a situation where you want to script something to download
        videos. For this I present to you *pytube*.
        
        *pytube* is a lightweight library written in Python. It has no third party
        dependencies and aims to be highly reliable.
        
        *pytube* also makes pipelining easy, allowing you to specify callback functions
        for different download events, such as  ``on progress`` or ``on complete``.
        
        Finally *pytube* also includes a command-line utility, allowing you to quickly
        download videos right from terminal.
        
        ## Features
        
        - Support for both progressive & DASH streams
        - Support for downloading complete playlist
        - Easily register ``on_download_progress`` & ``on_download_complete`` callbacks
        - Command-line interfaced included
        - Caption track support
        - Outputs caption tracks to .srt format (SubRip Subtitle)
        - Ability to capture thumbnail URL
        - Extensively documented source code
        - No third-party dependencies
        
        ## Quickstart
        
        This guide is only meant to cover the most basic usage of the library. For more
        detailed information, please refer to our
        [readthedocs](https://python-pytube.readthedocs.io) page.
        
        ### Installation
        
        Pytube requires an installation of python 3.6 or greater, as well as pip.
        Pip is typically bundled with python installations, and you can find options
        for how to install python at https://python.org.
        
        To install from pypi with pip:
        
        ```bash
        $ python -m pip install pytube
        ```
        
        Sometime, the pypi release becomes slightly outdated. To install from the
        source with pip:
        
        ```bash
        $ python -m pip install git+https://github.com/pytube/pytube
        ```
        
        ### Using pytube in a python script
        
        To download a video using the library in a script, you'll need to first import
        the YouTube class from the library, and pass it an argument of the video url.
        From there, you can access the streams and download them.
        
        ```python
         >>> from pytube import YouTube
         >>> YouTube('https://youtu.be/2lAe1cqCOXo').streams.first().download()
         >>> yt = YouTube('http://youtube.com/watch?v=2lAe1cqCOXo')
         >>> yt.streams
          ... .filter(progressive=True, file_extension='mp4')
          ... .order_by('resolution')
          ... .desc()
          ... .first()
          ... .download()
        ```
        
        ### Using the command-line interface
        
        Using the CLI is extremely straightforward as well. To download a video at the
        highest progressive quality, you can use the following command:
        ```bash
        $ pytube https://youtube.com/watch?v=2lAe1cqCOXo
        ```
        
        You can also do the same for a playlist:
        ```bash
        $ pytube https://www.youtube.com/playlist?list=PLS1QulWo1RIaJECMeUT4LFwJ-ghgoSH6n
        ```
        
Keywords: youtube,download,video,stream
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python
Classifier: Topic :: Internet
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
