Skip to main content

video-dl

PyPI version

video-dl is a naive online video downloader based on aiohttp.

Prerequisites

  • ffmpeg used to merge picture and sound to a complete video.
  • python 3.8 or above (required by := operator).
  • Node.js used to run javascript code locally.

You could check help manual in wiki to install these system dependencies.

Installation

pip3 install video-dl

Upgrading

pip3 install --upgrade video-dl

Typical usage

Download the highest-definition video

:warning: If there are special symbols in your url, please enclose it with quotation marks.

video-dl 'https://www.bilibili.com/video/BV15L411p7M8'

:warning: the highest depends my own view, maybe not the one you want.

Normal Usage

Download video which definition will be selected manually

video-dl -i 'https://www.bilibili.com/video/BV15L411p7M8'

Normal Usage

Download video to your specific directory

video-dl -d ~/tmp 'https://www.bilibili.com/video/BV15L411p7M8'

set download directory

Download video via your proxy

:underage: we have to access some non-existing sites via proxy.

video-dl -p http://172.30.176.1:10809 'https://cn.pornhub.com/view_video.php?viewkey=ph5c87e70498951'

use proxy

Try to download videos in the same playlist (experimental)

video-dl -l 'https://www.bilibili.com/video/BV1qy4y1V7qU'

lists

Combine these arguments.

video-dl -d /mnt/d/Download -l -i 'https://www.bilibili.com/video/BV1qy4y1V7qU'

combine arguments

Help document

Program's help manual auto generated by argparse

you could use video-dl -h to see the below help manual.

usage: video_dl [-h] [-i] [-l] [-d DIRECTORY] [-c COOKIE] [-p PROXY] [-v] url

A naive online video downloader based on aiohttp

positional arguments:
  url                   target url copied from online video website.

optional arguments:
  -h, --help            show this help message and exit
  -i, --interactive     Manually select download resources.
  -l, --lists           try to find a playlist and download all videos in it.
  -d DIRECTORY, --directory DIRECTORY
                        set target diretory to save video file(s).
  -c COOKIE, --cookie COOKIE
                        provide your cookie.
  -p PROXY, --proxy PROXY
                        set proxy. e.g.: http://127.0.0.1:10809
  -v, --version         show program's version number and exit

You could find more important information in [github](https://github.com/fengdongfa1995/video_dl).

Longer help manual written by myself

You could find how to install system prerequisites, FAQ and something else in github's wiki.

Supported websites

How was this shit created?

Getting Involved

You could discuss with me in github's Discussions, find bugs or submit your excelent ideas in github's Issues, my last but the biggest wish is getting your pull requests to improve this naive tool.

Metadata

Release files for video-dl 0.0.17

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for video-dl 0.0.17
File Size Uploaded
video-dl-0.0.17.tar.gz 53.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for video-dl 0.0.17
File Interpreter ABI Platform
video_dl-0.0.17-py3-none-any.whl Python 3 none any Details

Total release size: 112.6 kB

Release files / video-dl-0.0.17.tar.gz

Download URL video-dl-0.0.17.tar.gz
Size 53.3 kB
Tags Source
SHA-256 checksum
How to use checksums
b70050072d96829d8a67e77203aed28de6887a21fbe9e9a690460a7b27be0cae
BLAKE2b-256 checksum
How to use checksums
0b1afb4af7d1d51d4b4f566ed1714247a7fdbb9a23709c109cca1b76b19be0ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.7.0 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.6

Release files / video_dl-0.0.17-py3-none-any.whl

Download URL video_dl-0.0.17-py3-none-any.whl
Size 59.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fbe0bc7ffa86083d8aac0fc48ca43f34d80528f4aebec74711b2a29c29aa7c1b
BLAKE2b-256 checksum
How to use checksums
418b5267394faf2eae36d83b4f3ce81a0d24074c83945e5674cab22dc2965cd3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.2 importlib_metadata/4.7.0 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.9.6
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page