Use Node runtime for YouTube backups

bootstrap/host/README.md

@@ -28,7 +28,8 @@ The playbook:
 - configures apt repositories for Docker, Kubernetes, Helm, OpenTofu, and Brave
 - installs the captured Debian package set, filtering packages unavailable on
   the current Debian release
-- installs user-level pipx CLI tools such as `yt-dlp`
+- installs user-level pipx CLI tools such as `yt-dlp`, plus runtime helpers
+  such as `ffmpeg` and `nodejs`
 - installs Zoom from the upstream `.deb` when requested on amd64
 - adds `jv` to expected local groups
 - enables core services such as Docker, containerd, kubelet, ssh, cron, and

bootstrap/host/group_vars/debian_pc.yml

@@ -28,7 +28,8 @@ debian_pc_enable_services:
   - bluetooth
 
 debian_pc_pipx_packages:
-  - yt-dlp
+  - package: "yt-dlp[default]"
+    app: yt-dlp
 
 debian_pc_hold_packages:
   - containerd.io
@@ -41,9 +42,11 @@ debian_pc_base_packages:
   - bash-completion
   - ca-certificates
   - curl
+  - ffmpeg
   - git
   - gnupg
   - gpg
+  - nodejs
   - python3
   - python3-apt
   - rsync

bootstrap/host/playbook.yml

@@ -177,8 +177,13 @@
 
     - name: Install user pipx CLI tools
       ansible.builtin.command:
-        cmd: "python3 -m pipx install {{ item }}"
-        creates: "{{ debian_pc_user_home }}/.local/bin/{{ item }}"
+        argv:
+          - python3
+          - -m
+          - pipx
+          - install
+          - "{{ item.package }}"
+        creates: "{{ debian_pc_user_home }}/.local/bin/{{ item.app }}"
       become: true
       become_user: "{{ debian_pc_user }}"
       environment:

infra/youtube-backup/.env.example

@@ -15,6 +15,7 @@ YOUTUBE_BACKUP_COOKIES_FROM_BROWSER=
 YOUTUBE_BACKUP_FORMAT=bv*+ba/best
 YOUTUBE_BACKUP_MERGE_FORMAT=mp4
 YOUTUBE_BACKUP_SUB_LANGS=all,-live_chat
+YOUTUBE_BACKUP_JS_RUNTIMES=node
 YOUTUBE_BACKUP_SLEEP_REQUESTS=1
 YOUTUBE_BACKUP_RATE_LIMIT=
 YOUTUBE_BACKUP_EXTRA_ARGS=

infra/youtube-backup/README.md

@@ -12,7 +12,11 @@ The backup root defaults to `/data/youtube-backup`.
 pipx install yt-dlp
 ```
 
-If thumbnail embedding fails, install `ffmpeg` on the host.
+The Debian host bootstrap installs `yt-dlp`, `ffmpeg`, and `nodejs` for this
+helper. It installs yt-dlp with its default dependency group so the YouTube EJS
+challenge scripts are available, and the backup script passes
+`--js-runtimes node` by default. On another machine, install those tools before
+running the backup.
 
 ## Configure
 

infra/youtube-backup/backup-youtube.sh

@@ -22,6 +22,7 @@ FORMAT="${YOUTUBE_BACKUP_FORMAT:-bv*+ba/best}"
 OUTPUT_TEMPLATE="${YOUTUBE_BACKUP_OUTPUT_TEMPLATE:-%(playlist_title)s/%(upload_date>%Y-%m-%d,release_date>%Y-%m-%d,epoch>%Y-%m-%d)s - %(title)s [%(id)s].%(ext)s}"
 SUB_LANGS="${YOUTUBE_BACKUP_SUB_LANGS:-all,-live_chat}"
 MERGE_FORMAT="${YOUTUBE_BACKUP_MERGE_FORMAT:-mp4}"
+JS_RUNTIMES="${YOUTUBE_BACKUP_JS_RUNTIMES:-node}"
 RATE_LIMIT="${YOUTUBE_BACKUP_RATE_LIMIT:-}"
 SLEEP_REQUESTS="${YOUTUBE_BACKUP_SLEEP_REQUESTS:-1}"
 EXTRA_ARGS="${YOUTUBE_BACKUP_EXTRA_ARGS:-}"
@@ -73,6 +74,7 @@ args=(
     --sub-langs "${SUB_LANGS}"
     --embed-metadata
     --embed-thumbnail
+    --js-runtimes "${JS_RUNTIMES}"
     --sleep-requests "${SLEEP_REQUESTS}"
 )