# @warren-bank/node-hls-downloader-americastestkitchen > Command-line utility for downloading an offline copy of 'Americas Test Kitchen' HLS video streams. Latest version **1.0.1** (published 2023-05-27) · GPL-2.0 license · 0 weekly downloads ## Install ```sh npm install @warren-bank/node-hls-downloader-americastestkitchen pnpm add @warren-bank/node-hls-downloader-americastestkitchen yarn add @warren-bank/node-hls-downloader-americastestkitchen bun add @warren-bank/node-hls-downloader-americastestkitchen ``` Provides the command `atkdl`. ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 1.0.1 | | Published | 2023-05-27 | | First published | 2020-02-19 | | Weekly downloads | 0 | | License | GPL-2.0 | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 3 | | Unpacked size | 46.3 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 1 | | Author | Warren R. Bank | | Maintainers | warren-bank | ## Links - npm: https://www.npmjs.com/package/@warren-bank/node-hls-downloader-americastestkitchen - Repository: https://github.com/warren-bank/node-hls-downloader-americastestkitchen - Homepage: https://github.com/warren-bank/node-hls-downloader-americastestkitchen#readme - Issues: https://github.com/warren-bank/node-hls-downloader-americastestkitchen/issues - npm.io page: https://npm.io/package/@warren-bank/node-hls-downloader-americastestkitchen ## 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.1.0 - [@warren-bank/node-hls-downloader](https://npm.io/package/@warren-bank/node-hls-downloader.md) ^4.0.6 ## Recent versions - 1.0.1 (latest) — 2023-05-27 - 1.0.0 — 2020-02-19 ## README ### [_Americas Test Kitchen_ Downloader](https://github.com/warren-bank/node-hls-downloader-americastestkitchen) Command-line utility for downloading an offline copy of [_Americas Test Kitchen_](https://www.americastestkitchen.com/episodes/browse) HLS video streams. #### Features: * accepts URLs that identify: - a single episode * accepts CLI options to identify: - a single episode - a single season - all episodes in every season * downloads: - the highest available quality for each video stream - _vtt_ 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 | | | |- video.m3u8 | | | |- master.m3u8 | | |- mp4/ | | | |- video.mp4 | | | |- video.{language}.vtt | | | |- video.{language}.srt ``` - - - - #### Installation: ```bash npm install --global @warren-bank/node-hls-downloader-americastestkitchen ``` #### Usage: ```bash atkdl 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 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" "--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 an episode URL. "-i " "--input-file " Read episode URLs from a local text file. Format is one URL per line. "-a" "--all" Process all episodes in all seasons. "-s" "--season" Process all episodes in the specified season. "-e" "--episode" Process one specific episode in the specified season. Requires: '--season' ``` #### Example: * download an episode (by URL): ```bash # Season 20, Ep 7 - The Very Best Paris-Brest atkdl -q -mc 5 -u 'https://www.americastestkitchen.com/episode/653-the-very-best-paris-brest' ``` * download an episode (by CLI options): ```bash # Season 20, Ep 7 - The Very Best Paris-Brest atkdl -q -mc 5 -s 20 -e 7 ``` * download all episodes in one season: ```bash # Season 20 atkdl -q -mc 5 -s 20 ``` * download all episodes in all seasons: ```bash atkdl -q -mc 5 -a ``` * print a trace of the operations that would occur IF all episodes in one season were to be downloaded: ```bash # Season 20 atkdl -dr -ll 1 -s 20 atkdl -dr -ll 2 -s 20 atkdl -dr -ll 3 -s 20 ``` * download all episodes in one season (advanced): ```bash # Season 20 atkdl -dr -ll 1 -s 20 >'episode_urls.txt' atkdl -dr -ll 2 -s 20 >'convert_mp4s.sh' atkdl -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 _Americas Test Kitchen_ 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) * [ES6 support](http://node.green/) * v0.12.18+: [Promise](https://node.green/#ES2015-built-ins-Promise) * v4.08.03+: [Object shorthand methods](https://node.green/#ES2015-syntax-object-literal-extensions) * v5.12.00+: [spread syntax for iterable objects](https://node.green/#ES2015-syntax-spread-syntax-for-iterable-objects) * v6.04.00+: [rest parameters](https://node.green/#ES2015-syntax-rest-parameters) * v6.04.00+: [destructuring, declarations](https://node.green/#ES2015-syntax-destructuring--declarations) * v6.04.00+: [Proxy constructor](https://node.green/#ES2015-built-ins-Proxy) * v6.04.00+: [Proxy 'apply' handler](https://node.green/#ES2015-built-ins-Proxy) * v6.04.00+: [Reflect.apply](https://node.green/#ES2015-built-ins-Reflect) * v7.10.01+: [async functions](https://node.green/#ES2017-features-async-functions) * v8.06.00+: [object rest/spread properties](https://node.green/#ES2018-features-object-rest-spread-properties) * libraries and dependencies * v6.13.00+: [Browser-compatible `URL` class](https://nodejs.org/api/url.html#url_class_url) * FFmpeg * not required in `PATH` when using the `--no-mp4` CLI option * successfully tested with version: 4.1.3 #### Credits: * [_youtube-dl_ 'Americas Test Kitchen' extractor](https://github.com/ytdl-org/youtube-dl/blob/master/youtube_dl/extractor/americastestkitchen.py) * provides a methodology to obtain video stream URLs #### 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-americastestkitchen · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._