# @warren-bank/node-hls-downloader-tubitv > Command-line utility for downloading an offline copy of TubiTV HLS video streams. Latest version **2.0.0** (published 2025-12-01) · GPL-2.0 license · 0 weekly downloads ## Install ```sh npm install @warren-bank/node-hls-downloader-tubitv pnpm add @warren-bank/node-hls-downloader-tubitv yarn add @warren-bank/node-hls-downloader-tubitv bun add @warren-bank/node-hls-downloader-tubitv ``` Provides the command `tubidl`. ## Health **Score 45/100 (D)** — status: stable. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. ## Facts | | | |---|---| | Version | 2.0.0 | | Published | 2025-12-01 | | First published | 2020-02-10 | | Weekly downloads | 0 | | License | GPL-2.0 | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 3 | | Unpacked size | 47.4 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 106 | | Author | Warren R. Bank | | Maintainers | warren-r-bank | ## Links - npm: https://www.npmjs.com/package/@warren-bank/node-hls-downloader-tubitv - Repository: https://github.com/warren-bank/node-hls-downloader-tubitv - Homepage: https://github.com/warren-bank/node-hls-downloader-tubitv#readme - Issues: https://github.com/warren-bank/node-hls-downloader-tubitv/issues - npm.io page: https://npm.io/package/@warren-bank/node-hls-downloader-tubitv ## Dependencies (3) - [@warren-bank/mkdir-sync](https://npm.io/package/@warren-bank/mkdir-sync.md) ^1.0.2 - [@warren-bank/node-process-argv](https://npm.io/package/@warren-bank/node-process-argv.md) ^1.2.2 - [@warren-bank/node-hls-downloader](https://npm.io/package/@warren-bank/node-hls-downloader.md) ^4.0.8 ## Recent versions - 2.0.0 (latest) — 2025-12-01 - 1.5.8 — 2025-03-31 - 1.5.7 — 2023-09-19 - 1.5.6 — 2023-09-17 - 1.5.5 — 2023-05-26 - 1.5.4 — 2023-05-25 - 1.5.3 — 2023-05-25 - 1.5.2 — 2023-05-08 - 1.5.1 — 2023-04-23 - 1.5.0 — 2023-03-02 - 1.4.0 — 2023-03-02 - 1.3.3 — 2022-02-07 - 1.3.2 — 2020-02-13 - 1.3.0 — 2020-02-12 - 1.1.0 — 2020-02-12 - … 2 more at https://npm.io/package/@warren-bank/node-hls-downloader-tubitv/versions ## README ### [TubiTV Downloader](https://github.com/warren-bank/node-hls-downloader-tubitv) Command-line utility for downloading an offline copy of [TubiTV](https://tubitv.com/) HLS video streams. #### 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: ```bash |- {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 ``` - - - - #### Installation: ```bash npm install --global @warren-bank/node-hls-downloader-tubitv ``` #### Usage: ```bash tubidl 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" "--log-level" 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. "-mf" "--mp4-filename" Specify the numeric mode used to configure the filename of the .mp4 file container. 0 = "video.mp4" (default) 1 = "${movie-or-episode-title}.mp4" 2 = "${movie-title}.mp4" or "${series-title} - ${episode-title}.mp4" "-mc" "--max-concurrency" "--threads" Specify the maximum number of URLs to download in parallel. The default is 1, which processes the download queue sequentially. "-P" "--directory-prefix" Specifies the directory where the resulting file structure will be saved to. The default is "." (the current directory). "-u" "--url" Specify a TubiTV URL. (movie, episode, or series) "-i " "--input-file " Read TubiTV URLs from a local text file. Format is one URL per line. ``` #### Example: * download a movie: ```bash tubidl -q -mc 5 -u 'https://tubitv.com/movies/300443/1984' ``` * download an episode: ```bash tubidl -q -mc 5 -u 'https://tubitv.com/tv-shows/200255733/s01-e01-where-is-everybody' ``` * download a series: ```bash tubidl -mc 5 -u 'https://tubitv.com/series/300017350/the-twilight-zone' ``` * print a trace of the operations that would occur IF a series were to be downloaded: ```bash tubidl -dr -ll 1 -u 'https://tubitv.com/series/300017350/the-twilight-zone' tubidl -dr -ll 2 -u 'https://tubitv.com/series/300017350/the-twilight-zone' tubidl -dr -ll 3 -u 'https://tubitv.com/series/300017350/the-twilight-zone' ``` * download a series (advanced): ```bash tubidl -dr -ll 1 -u 'https://tubitv.com/series/300017350/the-twilight-zone' >'episode_urls.txt' tubidl -dr -ll 2 -u 'https://tubitv.com/series/300017350/the-twilight-zone' >'convert_mp4s.sh' tubidl -nm -mc 5 -i 'episode_urls.txt' >'log.txt' 2>&1 ./convert_mp4s.sh ``` ##### Suggestions: 1. 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 2. repeat the above process until the log file shows no download errors 3. 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` - - - - #### Requirements: * Node.js version: v8.6.0 (and higher) - transitive [dependency](https://github.com/warren-bank/node-hls-downloader-tubitv/blob/master/package.json#L12-L13) requirements: * v8.06.00+: [`@warren-bank/node-hls-downloader`](https://github.com/warren-bank/node-hls-downloader#requirements) * v8.06.00+: [`@warren-bank/node-process-argv`](https://github.com/warren-bank/node-process-argv#requirements) * FFmpeg - not required in `PATH` when using the `--no-mp4` CLI option * successfully tested with version: 4.1.3 #### Legal: * copyright: [Warren Bank](https://github.com/warren-bank) * license: [GPL-2.0](https://www.gnu.org/licenses/old-licenses/gpl-2.0.txt) --- _Source: https://npm.io/package/@warren-bank/node-hls-downloader-tubitv · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._