From 9884508ff286cf43f93fb3a9d68c5711ad6bdebf Mon Sep 17 00:00:00 2001 From: Simon Date: Mon, 25 Sep 2023 12:14:10 +0700 Subject: [PATCH] add manual yt-dlp update instructions --- mkdocs/docs/advanced.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/mkdocs/docs/advanced.md b/mkdocs/docs/advanced.md index db0f1f2..648835c 100644 --- a/mkdocs/docs/advanced.md +++ b/mkdocs/docs/advanced.md @@ -113,3 +113,30 @@ and you should get: ``` Then you can start everything again and the migration will run again. If your error persists, the ES and TA logs should give additional debug info. + +## Manual yt-dlp update +This project strives for timely updates when yt-dlp makes a new release, but sometimes ideals meet reality. Also sometimes yt-dlp has a fix published, but not yet released. + +Doing this is **very likely** going to break things for you. You will want to try this out on a testing instance first. Regularly there have been subtle changes in the yt-dlp API, so only do this if you know how to debug this project by yourself, but obviously share your fixes so any problems can be dealt with before release. + +**Build your own image**: Update the version in `requirements.txt` and rebuild the image from `Dockerfile`. This will use your own image, even on container rebuild. + +**Update yt-dlp on its own**: You can also update the yt-dlp library alone in the container. + +- Restart your container for changes to take effect. +- These changes won't persist a container rebuild from image. + +Update to newest regular yt-dlp release: + +``` +pip install --upgrade yt-dlp +``` + +To update to nightly you'll have to specify the correct `--target` folder: +``` +pip install \ + --upgrade \ + --target=/root/.local/bin \ + https://github.com/yt-dlp/yt-dlp/archive/master.tar.gz +``` +This is obviously particularly likely to create problems. Also note that the `--version` command will only show the latest regular release, not a nightly mention.