Download with yt-dlp using command line arguments or configuration files

Docker Youtube-DL

Build status Docker Pulls Docker Stars Docker Automated

GitHub last commit GitHub commit activity GitHub issues

Donate PayPal

• Works with command line arguments to youtube-dl
• Compatible with AMD64, 386, ARM v6/v7/v8 CPU architectures
• Small Docker image based on
  • Alpine 3.18
  • Youtube-dl
  • ffmpeg 6.0
  • Ca-Certificates
  • Python 3.11.4
• The container updates youtube-dl at launch if -e AUTOUPDATE=yes
• Docker healthcheck downloading https://duckduckgo.com with wget every 10 minutes
• You can receive a notification on your Android device through Gotify when the youtube-dl has finished

1. Run the container with

   docker run -d -v $(pwd)/yourdir:/downloads qmcgaw/youtube-dl-alpine \
   https://www.youtube.com/watch?v=HagVnWAeGcM \
   -o "/downloads/%(title)s.%(ext)s"

   or use docker-compose.yml with

   docker-compose up -d

2. See the youtube-dl command line options

3. By default the container runs as user ID 1000 in order to not run as root. If you encounter permission issues with your bind mounted yourdir directory, either:

   • Change the ownership and permission of your directory to match user id 1000:

     chown 1000 yourdir && chmod 700 yourdir

   • Run the container with the user ID owning yourdir, for example with the Docker flag --user=1030.

You can either:

• Change the ownership and permissions of ./downloads on your host with:

  chown 1000 -R ./downloads
  chmod 700 ./downloads
  chmod -R 600 ./downloads/*

• Launch the container as root user using --user=root

To authenticate you can bind mount a .netrc file.

You should, on your host, set the right ownership and permissions as follow:

chown 1000:1000 .netrc
chmod 600 .netrc

And then bind mount it with -v "$(pwd)/.netrc:/.netrc:ro" and youtube-dl will pick it up.

• Healthcheck to check ydl logs
• Colors in terminal