TubiTV Downloader
Command-line utility for downloading an offline copy of TubiTV HLS video streams.
Installation:
npm install --global @warren-bank/node-hls-downloader-tubitv
Features:
- accepts URLs that identify:
- a single movie
- a single episode contained in a series
- an entire series
- includes all episodes in every seasons
- downloads:
- the highest available quality for each video stream
- .srt subtitles for all available languages
- will continue upon restart after an abrupt interruption
- resulting file structure:
|- {title_series}/ | |- {title_episode}/ | | |- hls/ | | | |- video/ | | | | |- *.ts | | | |- audio/ | | | | |- {language}/ | | | | | |- *.ts | | | | |- {language}.m3u8 | | | |- subtitles/ | | | | |- {language}/ | | | | | |- *.vtt | | | | |- {language}.m3u8 | | | |- video.m3u8 | | | |- master.m3u8 | | |- mp4/ | | | |- video.mp4 | | | |- video.{language}.srt
Usage:
tubidl <options>
options:
========
"-h"
"--help"
Print a help message describing all command-line options.
"-v"
"--version"
Display the version.
"-q"
"--quiet"
Do not print a verbose log of operations.
"-ll" <integer>
"--log-level" <integer>
Specify the log verbosity level.
0 = no output (same as --quiet)
1 = include only episode TubiTV URLs
2 = include only episode ffmpeg commands
3 = include all operational metadata (default)
"-dr"
"--dry-run"
Do not write to the file system.
"-nm"
"--no-mp4"
Do not use "ffmpeg" to bundle the downloaded video stream into an .mp4 file container.
"-mc" <integer>
"--max-concurrency" <integer>
"--threads" <integer>
Specify the maximum number of URLs to download in parallel.
The default is 1, which processes the download queue sequentially.
"-P" <dirpath>
"--directory-prefix" <dirpath>
Specifies the directory where the resulting file structure will be saved to.
The default is "." (the current directory).
"-u" <URL>
"--url" <URL>
Specify a TubiTV URL. (movie, episode, or series)
"-i <filepath>"
"--input-file <filepath>"
Read TubiTV URLs from a local text file. Format is one URL per line.
Example:
- download a movie:
tubidl -q -mc 5 -u 'https://tubitv.com/movies/465487/citizenfour'
- download an episode:
tubidl -q -mc 5 -u 'https://tubitv.com/tv-shows/498780/s01_e02_the_grand_deception_part_2'
- download a series:
tubidl -mc 5 -u 'https://tubitv.com/series/4068/the_greatest_american_hero'
- print a trace of the operations that would occur IF a series were to be downloaded:
tubidl -dr -ll 1 -u 'https://tubitv.com/series/4068/the_greatest_american_hero' tubidl -dr -ll 2 -u 'https://tubitv.com/series/4068/the_greatest_american_hero' tubidl -dr -ll 3 -u 'https://tubitv.com/series/4068/the_greatest_american_hero'
- download a series (advanced):
tubidl -dr -ll 1 -u 'https://tubitv.com/series/4068/the_greatest_american_hero' >'episode_urls.txt' tubidl -dr -ll 2 -u 'https://tubitv.com/series/4068/the_greatest_american_hero' >'convert_mp4s.sh' tubidl -nm -mc 5 -i 'episode_urls.txt' >'log.txt' 2>&1 ./convert_mp4s.sh
suggestions:
- download with options:
--no-mp4 --log-level 3
- redirect stdout to a log file
- when download completes, check the log file for any error messages
- if any .ts chunks encountered a download problem
- identify the url of the TubiTV page that was being processed when this error occurred
- redownload that page (using the same
--directory-prefix
)- all previously downloaded data not be modified or deleted
- only missing data will be retrieved
- repeat the above process until the log file shows no download errors
- finally, convert the HLS stream to mp4
- the
ffmpeg
command to perform this conversion is included in the log file - when converting the episodes in a series, a list of all
ffmpeg
commands can be generated with the options:--dry-run --log-level 2
- the
Requirements:
- Node version: v6.13.0 (and higher)
- ES6 support
- v0.12.18+: Promise
- v4.08.03+: Object shorthand methods
- v5.12.00+: spread operator
- v6.04.00+: Proxy constructor
- v6.04.00+: Proxy 'apply' handler
- v6.04.00+: Reflect.apply
- URL
- v6.13.00+: Browser-compatible URL class
- tested in:
- v7.9.0
- ES6 support
- FFmpeg
- not required in
PATH
when using the--no-mp4
CLI option - successfully tested with version: 4.1.3
- not required in
Legal:
- copyright: Warren Bank
- license: GPL-2.0