Metadata-Version: 2.1
Name: nndownload
Version: 1.2
Summary: nndownload allows you to process videos and other links from Niconico.
Home-page: https://github.com/AlexAplin/nndownload
Author: AlexAplin
License: UNKNOWN
Description: # nndownload
        
        ![PyPI](https://img.shields.io/pypi/v/nndownload.svg)
        
        nndownload allows you to process videos and other links from [Niconico](http://nicovideo.jp), formerly known as Nico Nico Douga. It simulates the HTML5 player by performing a session request to get the HQ source. Where not available, it will fallback to the Flash player. Keep in mind that if your account doesn't have premium, it may download the LQ source during economy mode hours (12 PM - 2 AM JST). When not providing a login, some Flash videos will not be available for download or will only be available in a lower quality.
        
        ## Features
         - Download videos with comments, thumbnails, and metadata
         - Download user videos
         - Download mylists
         - Download videos faster using multiple threads
         - Generate stream URLs for Niconama broadcasts
         - Process text files with URLs
        
        ## Requirements
        ### Python version
        - Python >=3.6
        
        ### Dependencies
        - beautifulsoup4
        - requests
        - websockets
        
        # Installation
        ```bash
        pip install nndownload
        ```
        
        ## Usage
        ### Standalone
        ```
        usage: nndownload.py [options] input
        
        positional arguments:
          input                 URL or file
        
        optional arguments:
          -h, --help            show this help message and exit
          -u USERNAME, --username USERNAME
                                account username
          -p PASSWORD, --password PASSWORD
                                account password
          -n, --netrc           use .netrc authentication
          -q, --quiet           suppress output to console
          -l, --log             log output to file
          -v, --version         show program's version number and exit
        
        download options:
          -y PROXY, --proxy PROXY
                                http or socks proxy
          -o TEMPLATE, --output-path TEMPLATE
                                custom output path (see template options)
          -r N, --threads N
                                download using a specified number of multithreads
          -g, --no-login        create a download session without logging in
          -f, --force-high-quality
                                only download if the high quality source is available
          -m, --dump-metadata   dump video metadata to file
          -t, --download-thumbnail
                                download video thumbnail
          -c, --download-comments
                                download video comments
          -e, --english         request video on english site
          -aq AUDIO_QUALITY, --audio-quality AUDIO_QUALITY
                                specify audio quality (DMC videos only)
          -vq VIDEO_QUALITY, --video-quality VIDEO_QUALITY
                                specify video quality (DMC videos only)
        ```
        
        ### Module
        ```python
        import nndownload
        
        url = "https://www.nicovideo.jp/watch/sm35249846"
        output_path = "/tmp/{id}.{ext}"
        nndownload.execute("-g", "-o", output_path, url)
        ```
        
        ### Custom Output Paths
        Custom filepaths are constructed like standard Python template strings, e.g. `{uploader} - {title}.{ext}`. The available options are:
        
        - comment_count
        - description
        - duration
        - ext
        - id
        - mylist_count
        - published
        - quality
        - size_high
        - size_low
        - thread_id
        - thumbnail_url
        - title
        - uploader
        - uploader_id
        - url
        - view_count
        - audio_quality (DMC)
        - video_quality (DMC)
        
        ### Using Stream Links
        After generating a stream URL, the program must be kept running to keep the stream active. [mpv](https://github.com/mpv-player/mpv) and [streamlink](https://github.com/streamlink/streamlink) are the best options for playing generated stream URLs. Other programs that use aggressive HLS caching and threading may also work.
        
        For mpv:
        
        `mpv https://...`
        
        For streamlink, replace `https` with `hls` in the output stream URL:
        
        `streamlink "hls://..." best`
        
        ## Known Bugs
        - Check open issues.
        
        ## License
        This project is licensed under the MIT License.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Requires-Python: >=3.6
Description-Content-Type: text/markdown
