arakurumi / freevine

A Download Utility for Free Streaming Services

Freevine
^{A Download Utility for Free Streaming Services}

Features:

• Movies & TV-series
• Episode selection and batch options
• Quality selection
• Automatic PSSH, manifest, and key retreival
• Config file with customized settings
• Search option
• Option to add login credentials

Requirements:

• Python

• N_m3u8DL-RE

• ffmpeg

• mkvmerge

• mp4decrypt

• shaka packager

• hola-proxy (optional)

• Widevine Device File (.wvd)

Installation:

1. Install Python (check 'Add to PATH' if on Windows)
2. Clone main branch or download latest version from Releases
3. Place required tools inside Freevine folder OR add them to system PATH (recommended)
4. Create /utils/wvd/ folder and place either .wvd file or private_key and client_id blob inside
5. Install necessary packages: pip install -r requirements.txt

Tip

Clone/download the main branch for immediate fixes and updates

Usage:

Available arguments:

  --proxy TEXT                 Request or specify a proxy server
  --threads TEXT               Concurrent download fragments
  --format TEXT                Specify file format
  --muxer TEXT                 Select muxer
  --no-mux                     Choose to not mux files
  --save-name TEXT             Name of saved file
  --save-dir TEXT              Save directory
  --sub-only                   Download only subtitles
  --sub-no-mux                 Choose to not mux subtitles
  --sub-no-fix                 Leave subtitles untouched
  --use-shaka-packager         Use shaka-packager to decrypt
  --add-command TEXT           Add extra command to N_m3u8DL-RE
  -fn, --force-numbering       Force add numbering to episodes
  -e, --episode TEXT           Download episode(s)
  -s, --season TEXT            Download complete season
  -c, --complete               Download complete series
  -m, --movie                  Download movie
  -t, --titles                 List all titles
  -i, --info                   Print title info
  -sv, --select-video TEXT     Select video stream
  -sa, --select-audio TEXT     Select audio stream
  -dv, --drop-video TEXT       Drop video stream
  -da, --drop-audio TEXT       Drop audio stream
  -ss, --select-subtitle TEXT  Select subtitle
  -ds, --drop-subtitle TEXT    Drop subtitle

Examples:

freevine.py get --help (READ THIS!)

freevine.py get --titles URL
freevine.py get --movie URL
freevine.py get --info --episode S01E01 URL
freevine.py get --subtitles --episode S01E01 URL
freevine.py get --episode S01E01 URL
freevine.py get --episode "name of episode" URL
freevine.py get --episode EPISODE_URL
freevine.py get --episode S01E01-S01E10 URL
freevine.py get --episode S01E01,S03E12,S05E03 URL
freevine.py get --season S01,S03,S05 URL
freevine.py get --select-video res=720 --season S01 URL
freevine.py get --select-audio name=English --episode S01E01 URL

freevine.py profile --help
freevine.py profile --username "username" --password "password" --service "service"

freevine.py search --help
freevine.py search iplayer "KEYWORDS"

Tip

See "N_m3u8DL-RE --morehelp select-video/audio/subtitle" for possible selection patterns

Disclaimer

1. This project is purely for educational purposes and does not condone piracy
2. RSA key pair required for key derivation is not included in this project