qmcgaw/youtube-dl-alpine repository overview

⁠Docker Youtube-DL Alpine

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

⁠Features

• 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

⁠Setup

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"
   

   Copy

   or use docker-compose.yml⁠ with

   docker-compose up -d
   

   Copy

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
     

     Copy

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

⁠Environment variables

⁠Downloads directory permission issues

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/*
  

  Copy

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

⁠Authenticate with Netrc file

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.

⁠TODOs

• Healthcheck to check ydl logs
• Colors in terminal