Skip to content

Commit e9f5b35

Browse files
committed
docs(readme): document yt-dlp upgrade guidance for YouTube 403 errors
1 parent 4e26264 commit e9f5b35

1 file changed

Lines changed: 4 additions & 1 deletion

File tree

README.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,10 +86,12 @@ If you don't have `pip`, you can use `python -m pip` instead.
8686

8787
The package depends on `yt-dlp[default]`, so the Python install will also pull in yt-dlp's recommended companion components such as `yt-dlp-ejs`. You still need an external JavaScript runtime like Deno or Node.js installed separately on your system for the best YouTube support.
8888

89+
If `yt-dlp` is already present in your Python environment, upgrade it alongside the app. `pip install yt-channel-downloader` can otherwise keep an older `yt-dlp` that still satisfies the dependency floor but no longer works reliably against recent YouTube player changes.
90+
8991
To update the app to the latest version from PyPI:
9092

9193
```bash
92-
pip install --upgrade yt-channel-downloader
94+
pip install --upgrade yt-channel-downloader yt-dlp
9395
yt-channel-downloader
9496
```
9597

@@ -272,6 +274,7 @@ yt-channel-downloader
272274
- **Fetch limits**: `File -> Settings` lets you control the maximum number of videos fetched per channel and per playlist.
273275
- **Proxy support**: The Settings dialog includes `HTTPS`, `SOCKS4`, and `SOCKS5` proxy options.
274276
- **Browser cookies**: Use `File -> Use Browser Cookies for Login` to choose a signed-in browser profile for restricted YouTube downloads. Once configured, the menu item changes to `Clear Login`.
277+
- **YouTube 403 / missing formats**: If downloads fail with `HTTP Error 403`, `Requested format is not available`, `n challenge solving failed`, or `SABR` warnings, upgrade both the app and `yt-dlp` with `python -m pip install --upgrade yt-channel-downloader yt-dlp`. Older `yt-dlp` builds can still satisfy the package dependency but fail against newer YouTube player scripts.
275278
- **Application logs**: If something fails and you want to report it, check the app log in the config directory under `logs/application.log`. On Linux this is typically `~/.config/yt_chan_dl/logs/application.log`.
276279
277280
## Contributing

0 commit comments

Comments
 (0)