From 1bca8a134da63dcaf31380b9dc11a4890e8302ab Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Fri, 30 Jan 2026 15:26:56 -0600
Subject: feat(archsetup): add hyprland plugins and migrate yt-dlp to pipx

Add Hyprland plugin section with hyprpm for hyprscrolling, xtra-dispatchers,
and hy3. Migrate yt-dlp from pacman to pipx for current releases. Add deno
as required JS runtime for YouTube extraction.
---
 assets/2026-01-30-yt-dlp-deno-requirement.md | 24 +++++++++++++++++++++
 assets/2026-01-30-yt-dlp-pipx-migration.md   | 32 ++++++++++++++++++++++++++++
 2 files changed, 56 insertions(+)
 create mode 100644 assets/2026-01-30-yt-dlp-deno-requirement.md
 create mode 100644 assets/2026-01-30-yt-dlp-pipx-migration.md

(limited to 'assets')

diff --git a/assets/2026-01-30-yt-dlp-deno-requirement.md b/assets/2026-01-30-yt-dlp-deno-requirement.md
new file mode 100644
index 0000000..84e11fa
--- /dev/null
+++ b/assets/2026-01-30-yt-dlp-deno-requirement.md
@@ -0,0 +1,24 @@
+# Install deno for yt-dlp JavaScript runtime
+
+## Problem
+
+yt-dlp now requires a JavaScript runtime for full YouTube extraction. Without it, you get this warning:
+
+```
+WARNING: No supported JavaScript runtime could be found.
+YouTube extraction without a JS runtime has been deprecated, and some formats may be missing.
+```
+
+## Solution
+
+Install deno (the default supported runtime):
+
+```bash
+sudo pacman -S deno
+```
+
+## Why
+
+YouTube uses JavaScript for some format extraction. Without a JS runtime, yt-dlp may not be able to access all video formats or could fail on certain videos.
+
+See: https://github.com/yt-dlp/yt-dlp/wiki/EJS
diff --git a/assets/2026-01-30-yt-dlp-pipx-migration.md b/assets/2026-01-30-yt-dlp-pipx-migration.md
new file mode 100644
index 0000000..a128baa
--- /dev/null
+++ b/assets/2026-01-30-yt-dlp-pipx-migration.md
@@ -0,0 +1,32 @@
+# Change yt-dlp installation from pacman to pipx
+
+## Problem
+
+yt-dlp stopped working because the Arch repos were behind upstream. The pacman version was 2025.12.08 while the latest release was 2026.01.29 (7 weeks behind).
+
+yt-dlp updates frequently to keep up with site API changes, so being outdated often causes extraction failures.
+
+## Solution
+
+Install yt-dlp via pipx instead of pacman:
+
+```bash
+# Install pipx if not already installed
+sudo pacman -S python-pipx
+
+# Install yt-dlp via pipx
+pipx install yt-dlp
+
+# Remove the pacman version to avoid PATH conflicts
+sudo pacman -R yt-dlp
+```
+
+## Updating
+
+To update yt-dlp in the future:
+
+```bash
+pipx upgrade yt-dlp
+```
+
+This pulls directly from PyPI which stays current with upstream releases.
-- 
cgit v1.2.3