docs: fix the yt-dlp advice — a separate venv is not an importable one
`pipx install yt-dlp` was the instruction here, and it never worked. It gives yt-dlp its own venv, so the binary lands on PATH while gallery-dl, living in a different venv, still cannot `import yt_dlp`. Everything looks installed and the log keeps saying `Cannot import yt-dlp or youtube-dl` — which is exactly what the first run logged, and why it fell back to progressive URLs for DASH video, the path the CDN 429s hit hardest. `pipx inject gallery-dl yt-dlp` is the fix. Verify it by asking gallery-dl's own interpreter rather than the shell, since `which yt-dlp` succeeds either way and is what made the original advice look correct. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UXfdJu7QhSJLr47K7koTDF
This commit is contained in:
+17
-1
@@ -426,7 +426,23 @@ Re-running with those recovered both videos and produced **0 failures and 0
|
|||||||
|
|
||||||
Without it, gallery-dl logs `Cannot import yt-dlp or youtube-dl` and falls back
|
Without it, gallery-dl logs `Cannot import yt-dlp or youtube-dl` and falls back
|
||||||
to a progressive URL for DASH videos. The fallback mostly works but is what the
|
to a progressive URL for DASH videos. The fallback mostly works but is what the
|
||||||
429s hit hardest. `pipx install yt-dlp` on the fetch host.
|
429s hit hardest.
|
||||||
|
|
||||||
|
**`pipx install yt-dlp` does not work** — it was the advice here until
|
||||||
|
2026-08-20, and it is wrong. It gives yt-dlp its own venv, so the binary lands
|
||||||
|
on `PATH` while gallery-dl, in a *different* venv, still cannot `import yt_dlp`.
|
||||||
|
The symptom is that everything looks installed and the log keeps saying
|
||||||
|
`Cannot import yt-dlp`. gallery-dl needs it importable, not runnable:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
pipx inject gallery-dl yt-dlp
|
||||||
|
```
|
||||||
|
|
||||||
|
Verify by asking gallery-dl's own interpreter, not the shell:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
/home/matt/.local/share/pipx/venvs/gallery-dl/bin/python -c 'import yt_dlp'
|
||||||
|
```
|
||||||
|
|
||||||
## Known quirks
|
## Known quirks
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user