README_JA.md

nndownload

EN | JA

nndownload では、 Niconico(通称ニコニコ動画)から動画、画像、マンガをダウンロードしたり、その他のリンクを処理したりできます。従来のダウンローダーとは異なり、nndownload では DMC(Dwango Media Cluster)と DMS(Dwango Media Services)サーバーと通信して、高品質の動画へのアクセスを確保します。

Disclaimers

• プレミアムアカウントを持っていない場合、エコノミーモードの時間帯 (通常は日本時間の午後 12 時～午前 2 時) または混雑する時間帯では低品質の動画となります。
• ログインせずに (-g/--no-login を使用して) ダウンロードする場合、一部の動画はダウンロードできないか、低品質でしか利用できない場合があります。
• 同じ接続で複数のダウンロードセッションを実行すると、一時的なブロックやスロットリングが発生する可能性があります。
• 次の機能は現在サポートされていません。
  • ニコ生タイムシフトのダウンロード
  • ニコニコ静画コメントのダウンロード
  • チャンネルやブログ、コメントのダウンロード

Features

• コメント、サムネイル、メタデータを含む動画のダウンロード
• メタデータを含むニコニコ静画の画像やマンガのダウンロード
• メタデータを含むチャンネル動画やブログのダウンロード
• マイリストのダウンロード
• ユーザの動画、マイリスト、イラスト、マンガのダウンロード
• ニコ生用のストリーム URL の生成
• 複数スレッドによる動画ダウンロードの高速化
• テキストファイルで受け取った URL リストの処理

Requirements

Python version

Python >=3.5.3

Dependencies

requirements.txtを参照

Installation

pip install nndownload

Usage

CLI

usage: nndownload.py [options] input

positional arguments:
  input                 URLs or files

options:
  -h, --help            ヘルプメッセージを表示
  -u EMAIL/TEL, --username EMAIL/TEL
                        アカウントのメールアドレスor電話番号
  -p PASSWORD, --password PASSWORD
                        アカウントのパスワード
  --session-cookie COOKIE
                        user_session クッキー値 (文字列またはファイルパス)
  -n, --netrc           .netrcを認証に利用
  -q, --quiet           コンソールに出力しない
  -l [PATH], --log [PATH]
                        ファイルにログ出力
  -v, --version         プログラムのバージョン情報を表示

download options:
  -y PROXY, --proxy PROXY
                        http or socks proxy
  -o TEMPLATE, --output-path TEMPLATE
                        出力パスを指定 (テンプレートオプションを参照)
  -r N, --threads N     指定したスレッド数で動画をダウンロードする
  -g, --no-login        ログインなしでダウンロードセッションを作成
  -f, --force-high-quality
                        高品質な動画ソースが利用可能な場合のみダウンロードを行う
  -a, --add-metadata    動画ファイルにメタデータを付与 (MP4 only)
  -m, --dump-metadata   メタデータをファイルにダンプ
  -t, --download-thumbnail
                        動画のサムネイルをダウンロード
  -c, --download-comments
                        動画のコメントをダウンロード
  -e, --english         英語版サイトにリクエストする
  -chinese              中文版サイトにリクエストする
  -aq AUDIO_QUALITY, --audio-quality AUDIO_QUALITY
                        音質を指定
  -vq VIDEO_QUALITY, --video-quality VIDEO_QUALITY
                        画質を指定
  -an, --no-audio       音声をダウンロードしない
  -vn, --no-video       動画をダウンロードしない
  -Q, --list-qualities  リストの画質と音質
  -s, --skip-media      メディアのダウンロードをスキップ
  --break-on-existing   既存のダウンロードが見つかったら抜ける
  --playlist-start N    リストの開始番号を指定 (最小値：0)

Module

import nndownload

url = "https://www.nicovideo.jp/watch/sm35249846"
output_path = "/tmp/{id}.{ext}"
nndownload.execute("-g", "-o", output_path, url)

Custom Output Paths

カスタムファイルパスは、標準の Python テンプレート文字列のように構築されます。例：{uploader} - {title}.{ext}
ニコニコ静画の場合、出力パスはチャプターディレクトリのテンプレートにする必要があります。例：{manga_id}\{id} - {title}
利用可能なオプションは以下の通りです。

• comment_count (videos, images, manga, articles)
• description (videos, images, manga)
• document_url (videos, images, manga, articles)
• ext (videos, images, articles)
• id (videos, images, manga, articles)
• published (videos, images, manga, articles)
• tags (videos, images, manga, articles)
• title (videos, images, manga, articles)
• uploader (videos, images, manga, articles)
• uploader_id (videos, images, manga, articles)
• url (videos, images)
• view_count (videos, images, manga)
• audio_quality (videos)
• video_quality (videos)
• article (articles)
• blog_title (articles)
• clip_count (images)
• dms_video_uri (videos)
• dms_audio_uri (videos)
• duration (videos)
• manga_id (manga)
• manga_title (manga)
• mylist_count (videos)
• page_count (manga)
• size_high (videos)
• size_low (videos)
• thread_id (videos)
• thread_key (videos)
• thread_params (videos)
• thumbnail_url (videos)

Using Stream Links

ストリーム URL の生成後は、ストリームをアクティブな状態に保つためにプログラムを実行し続ける必要があります。生成されたストリーム URL を再生するには、mpvとstreamlinkが最適なオプションです。ただし、アグレッシブな HLS キャッシングとスレッドを使用する他のプログラムも動作する可能性があります。

mpv https://... streamlink https://... best

Known Bugs

• 既知のバグについては open issues をご参照ください。

License

This project is licensed under the MIT License.