Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

nndownload allows you to process videos and other links from Niconico.

Project description



nndownload allows you to process videos and other links from Niconico, 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.


  • Download videos with comments, thumbnails, and metadata
  • Download Nico Seiga images and manga
  • Download a user's videos
  • Download mylists
  • Download videos faster using multiple threads
  • Generate stream URLs for Niconama broadcasts
  • Process text files with URLs


Python version

  • Python >=3.6


  • beautifulsoup4
  • requests
  • websockets


pip install nndownload



usage: [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)


import nndownload

url = ""
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}. For Nico Seiga manga and comics, the output path should be the template for a chapter directory, e.g. {manga_id}\{id} - {title}. 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)
  • manga_id (Seiga)
  • manga_title (Seiga)
  • page_count (Seiga)
  • clip_count (Seiga)

Using Stream Links

After generating a stream URL, the program must be kept running to keep the stream active. mpv and 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.


This project is licensed under the MIT License.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nndownload, version 1.3
Filename, size File type Python version Upload date Hashes
Filename, size nndownload-1.3.tar.gz (17.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page