# yt-dlp Docker Image

**A yt-dlp Docker image for downloading YouTube subscriptions and for use with yt-ops-client.**

yt-dlp documentation [here](https://github.com/yt-dlp/yt-dlp).

# Building the Image

A helper script is provided to build the Docker image.

```bash
# From the root of the repository
./bin/build-yt-dlp-image
```

This will build the image and tag it based on the version in `ytops_client/youtube-dl/release-versions/latest.txt`. For example, if the file contains `2025.12.08`, the script will create the tags `ytops/yt-dlp:2025.12.08` and `ytops/yt-dlp:latest`.

You can also specify a custom image name:
```bash
./bin/build-yt-dlp-image my-registry/my-yt-dlp
```

## Updating yt-dlp

To update the version of `yt-dlp` used in the image:

1.  Modify the version string in `ytops_client/youtube-dl/release-versions/latest.txt`.
2.  Rebuild the image using the build script:
    ```bash
    ./bin/build-yt-dlp-image
    ```
3.  If you have a running container, you will need to stop, remove, and recreate it to use the new image.