movie-downloader 0.4.0

Movie Downloader

A fast movie downloader using Aria2

Supported sites

• Tencent Video
• m1905
• iQIYI
• M3u8

Third-party Dependencies

• Aria2

  • For Windows:

    i686 32-bit version:

    https://github.com/Jesseatgao/aria2-patched-static-build/releases/download/1.37.0-win-linux--builder-win32-v1.8-el9/aria2-i686-win.zip

    x86_64 64-bit version:

    https://github.com/Jesseatgao/aria2-patched-static-build/releases/download/1.37.0-win-linux--builder-win32-v1.8-el9/aria2-x86_64-win.zip

  • For Linux:

    i686 32-bit version:

    https://github.com/Jesseatgao/aria2-patched-static-build/releases/download/1.37.0-win-linux--builder-win32-v1.8-el9/aria2-i686-linux.tar.xz

    x86_64 64-bit version:

    https://github.com/Jesseatgao/aria2-patched-static-build/releases/download/1.37.0-win-linux--builder-win32-v1.8-el9/aria2-x86_64-linux.tar.xz

• FFmpeg

  • For Windows:

    i686 32-bit version:

    https://www.videohelp.com/download/ffmpeg-4.2.2-win32-static.zip

    x86_64 64-bit version:

    https://www.videohelp.com/download/ffmpeg-7.0.2-full_build.7z

  • For Linux:

    i686 32-bit version:

    https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-i686-static.tar.xz

    x86_64 64-bit version:

    https://johnvansickle.com/ffmpeg/releases/ffmpeg-release-amd64-static.tar.xz

• MKVToolnix(mkvmerge)

  • For Windows:

    i686 32-bit version:

    https://github.com/Jesseatgao/MKVToolNix-static-builds/releases/download/v58.0.0-mingw-w64-win32v1.8el9/mkvtoolnix-i686-win.zip

    x86_64 64-bit version:

    https://github.com/Jesseatgao/MKVToolNix-static-builds/releases/download/v58.0.0-mingw-w64-win32v1.8el9/mkvtoolnix-x86_64-win.zip

  • For Linux:

    i686 32-bit version:

    https://github.com/Jesseatgao/MKVToolNix-static-builds/releases/download/v58.0.0-mingw-w64-win32v1.8el9/mkvtoolnix-i686-linux.tar.xz

    x86_64 64-bit version:

    https://github.com/Jesseatgao/MKVToolNix-static-builds/releases/download/v58.0.0-mingw-w64-win32v1.8el9/mkvtoolnix-x86_64-linux.tar.xz

• node

  • For Windows:

    i686 32-bit version:

    https://nodejs.org/dist/v16.15.0/node-v16.15.0-win-x86.zip

    x86_64 64-bit version:

    https://nodejs.org/dist/v16.15.0/node-v16.15.0-win-x64.zip

  • For Linux:

    i686 32-bit version:

    https://unofficial-builds.nodejs.org/download/release/v16.15.0/node-v16.15.0-linux-x86.tar.xz

    x86_64 64-bit version:

    https://nodejs.org/dist/v16.15.0/node-v16.15.0-linux-x64.tar.xz

• ckey

  • For Windows & Linux:

    https://vm.gtimg.cn/tencentvideo/txp/js/ckey.wasm

Installation

Step 1: install core parsing modules

• via PyPI

  $ pip install movie-downloader

• from within source directory locally

  $ pip install .

Step 2: get and install third-party dependency programs

• Automatically

  $ mdl_3rd_parties [--proxy {http|socks5}://[user:password@]host:port]

• Manually

  Download, unzip and extract aria2, ffmpeg, mkvmerge, node and ckey into the directory third_parties/aria2/, third_parties/ffmpeg/, third_parties/mkvtoolnix/, third_parties/node/ and third_parties/ckey/ according to the target platform, respectively.

Usage

mdl [-h] [-C] [-V] [-D DIR] [-d {suhd,uhd,dolby,hdr10,fhd,shd,hd,sd}]
    [-p PROXY] [--proxy-dl-video [{True,False}]]
    [--no-logo [{True,False}]] [--ts-convert [{True,False}]]
    [--skip-discontinuity [{True,False}]] [--opening-discontinuity [{True,False}]]
    [-A ARIA2C] [-F FFMPEG] [-M MKVMERGE] [-N NODE]
    [-L {debug,info,warning,error,critical}] [--merge-all [{True,False}]]
    [--delete-after-merge [{True,False}]] [--delay-delete [{True,False}]]
    [--dl-video-with-cookie [{True,False}]]
    url [url ...] [--playlist-items PLAYLIST_ITEMS]

Description:

-D DIR: specify DIR to save downloaded videos.

-d {suhd,uhd,dolby,hdr10,fhd,shd,hd,sd}: specify the definition of the video to download. suhd,uhd,dolby,hdr10,fhd,shd,hd,sd correspond to Enhanced 4K, 4K, Dolby Vision, HDR10, 1080P, 720P, 480P, 270P respectively.

-p PROXY: specify the proxy server PROXY (in the form of http://[user:password@]host:port) used to get web pages, and download videos (if configured in conf/dlops.conf or enabled by the option --proxy-dl-video).

--proxy-dl-video [{True,False}]: specify whether the proxy should be used to download video contents. Default to False.

--no-logo [{True,False}]: indicate whether we're trying to download no-watermarked videos or not. If not set, default to True.

--ts-convert [{True,False}]: specify whether to convert (aggregated) TS file to MP4 format or not. If not set, default to True.

--skip-discontinuity [{True,False}]: specify whether to skip the segments in between the DISCONTINUITY tags or not. If not set, default to False.

--opening-discontinuity [{True,False}]: specify whether the first media segment is a DISCONTINUITY or not. If not set, default to False.

-A ARIA2C: specify the absolute path to aria2c executable, which takes precedence over the configuration in conf/misc.conf and the hard-coded fallback path third_parties/aria2/aria2c[.exe].

-F FFMPEG: specify the absolute path to ffmpeg executable, which takes precedence over the configuration in conf/misc.conf and the hard-coded fallback path third_parties/ffmpeg/ffmpeg[.exe].

-M MKVMERGE: specify the absolute path to mkvmerge executable, which takes precedence over the configuration in conf/misc.conf and the hard-coded fallback path third_parties/mkvtoolnix/mkvmerge[.exe].

-N NODE: specify the absolute path to node executable, which takes precedence over the configuration in conf/misc.conf and the hard-coded fallback path third_parties/node/node[.exe].

-L {debug,info,warning,error,critical}: specify logging level.

--merge-all [{True,False}]: specify whether to merge all the video clips or not. If not set, default to True.

--delete-after-merge [{True,False}]: specify whether to delete the original clips after merging. If not set, default to True.

--delay-delete [{True,False}]: specify whether to eagerly free up the disk space or not. If not set, default to True.

--dl-video-with-cookie [{True,False}]: specify whether to send cookies along with the video downloading request. If not set, default to False.

url [url ...]: one or more web page URLs of video episodes, cover and playlist.

--playlist-items PLAYLIST_ITEMS: desired episode indices in a playlist separated by commas, while the playlists are separated by semicolons, e.g. --playlist-items 1,2,5-10, --playlist-items 1,2,5-10;3-, and --playlist-items 1,2,5-10;;-20.

-C, --show-config-dir: show the configuration directories and exit.

-V, --version: show program's version number and exit.

Configuration

• Find out where the configuration files reside

  $ mdl -C

• Get the cookies string or cookies.txt file in Netscape format

  See Get cookies.txt LOCALLY for information on how to get cookies.txt for a video site.

Credits

• youtube-dl - an App to download videos from YouTube and other video platforms
• YouKuDownLoader - a video downloader focused on China mainland video sites
• iqiyi-parser - a video downloader for iqiyi, bilibili and TencentVideo sites
• Dlink_Parse - a video media addresses parser