sakkyoi / ncp-downloader

A tool for network performance testing by downloading videos from a well-known online video platform.

ncp-downloader is a tool for network performance testing by downloading videos from a well-known online video platform.

Installation

Download the latest release from the Releases page and extract it to the directory of your choice on your local machine.

Usage

ncp QUERY [OUTPUT_DIR] [OPTIONS]

QUERY is a URL of video or channel.

-r RESOLUTION, --resolution RESOLUTION      Target resolution. Defaults to highest resolution.
-R, --resume                                Resume download.
-t, --transcode                             Transcode video.
--ffmpeg FFMPEG                             Path to ffmpeg. Defaults to ffmpeg in PATH.
--vcodec VCODEC                             Video codec for transcoding.
--acodec ACODEC                             Audio codec for transcoding.
--ffmpeg-options FFMPEG_OPTIONS             Additional ffmpeg options. (e.g. --ffmpeg-options "-acodec copy -vcodec copy")
--thread THREAD                             Number of threads for downloading. Defaults to 1. (highly not recommended)
--select-manually                           Select video manually. This option only works with channel.
--username USERNAME                         Username for login.
--password PASSWORD                         Password for login.
--debug                                     Enable debug mode.
--help                                      Show help message.

If login credentials are provided, a session token will be generated and saved locally. DO NOT SHARE THE TOKEN WITH ANYONE.
Sometimes this tool may not function properly, delete temp files and folder to make it re-download the video.
(Feel free to modify the .json file if you understand what you are doing.)

--select-manually

When downloading a channel, you can use this option to select the video manually.

• arrow up/arrow down, arrow left/arrow right: Navigate
• space: Select/deselect
• enter: Start downloading
• ctrl+r: Deselct all
• ctrl+a: Select all
• ctrl+w: Use filter

The filter is case-insensitive and supports lambda expressions. Video will be selected if matched.

• /only <keyword>: Leave only the video that contains the keyword.
• /add <keyword>: Add the video that contains the keyword. (keep the original selection)
• /remove <keyword>: Remove the video that contains the keyword. (keep the original selection)
• /lambda <lambda expression>: Use lambda expression to filter the video.

The syntax of the lambda expression does not need to include the lambda x: part, and should return a boolean value.
The following is an example of a lambda expression that selects the video with

• title containing "ASMR",
• length of title is greater than 30,
• index is greater than 10,
• and the content code contains letter "R".

/lambda "ASMR" in x.title and len(x.title) > 30 and x.index > 10 and "R" in x.content_code

the x object has the following attributes:

• title: Title of the video.
• index: Index of the video.
• content_code: Content code of the video.

NOTE: lambda expression is case-sensitive. You can use .lower() to make it all lowercase.
python built-in functions and variables are available in the lambda expression.

Using this tool may lead to account suspension or ban. Use it at your own discretion.

Disclaimer

Please do use this tool responsibly and respect the rights of the content creators.
You should ONLY use this tool for network performance testing under any circumstances.
Data downloaded using this tool should be for personal use only. Obtain permission from the original creator before use.

License

This project is licensed under the LGPLv3 License - see the LICENSE file for details.