Repository files navigation

simple youtube download micro web queue server.To prevent a queue attack when using NAS as a server, a making account was created when creating a docker container, and a new UI was added.This Queue server based on python3 and debian Linux.

https://hub.docker.com/r/modenaf360/youtube-dl-nas/

• web server :bottle
• youtube-dl :youtube-dl.
• yt-dlp :yt-dlp.
• base :python queue server.
• websocket :bottle-websocket.

• 2025.07.06 : [Patch]Version 25.0706 - July 8, 2025

New Features:

• Added Terms of Use agreement screen for first-time users
• Added subtitle download function
• Enhanced security with dynamic secret key generation
• Improved copyright compliance with clear usage guidelines

Technical Updates:

• Moved download_history.json to ./metadata/ directory for single volume mount persistence and protection from clear all operation
• Disabled the clear-all button to prevent accidental mass deletion
• fixed Chrome download failure for filenames with special characters.
• Auth.json now includes TERMS_ACCEPTED flag and SECRET_KEY
• Session cookies now use dynamically generated cryptographic keys
• Added safeguards to prevent unauthorized usage

Security:

• Implemented unique secret key generation on initial setup
• Random 32-character alphanumeric key enhances session protection
• Previous session tokens automatically invalidated on key regeneration

Note: This update requires acceptance of Terms of Use before accessing the application.

These updates make the project more robust, user-friendly, and adaptable to various use cases.

• 2025.06.13 : [Patch] update python version, UI/UX overhaul, added file download and delete functionality.This project has undergone several updates to enhance functionality and user experience:

  • UI/UX Overhaul: Redesigned interface for improved usability and aesthetics.
  • File Management: Added functionality to download and delete files directly from the UI.
  • Improved Stability: Introduced a 1-second delay between retries to handle network blips effectively.
  • Switch toyt-dlp: Replacedyoutube-dl withyt-dlp for better performance and error handling.
  • Proxy Support: Added optional proxy configuration foryoutube-dl.
  • Resolution Options: Support for resolutions up to 2160p (4K) and audio-only downloads.
  • WebSocket Integration: Real-time download queue status updates via WebSocket.
  • HTTPS Compatibility: Modified to work seamlessly behind HTTPS.
  • Scheduler Update: Automated daily updates foryt-dlp to ensure compatibility with the latest changes.
  • REST API: Added REST API for programmatic interaction with the server.
  • Progress Bar: Added visual progress indicators to track download status in real-time.
  • File Management Controls: Implemented buttons for selective or bulk deletion of downloaded files on the server.

• 2025.06.12 : [Patch] Don’t reset the form; use .value = "" to avoid reselecting options like mp3 each time.

• 2025.06.11 : [Patch] Add 1s delay between retries to allow recovery from network blips.

• 2023.02.19 : [Patch] Changed the executable from youtube-dl to yt-dlp for fixed error about 'Unable to extract uploader id' and download speed..

• 2022.09.29 : [Patch] Check for updates essential packages on first startup container.

• 2022.09.28 : [Patch] Clears URL input when submitting the form.

• 2021.12.09 : [Patch] Fix proxy setting bug

• 2021.05.03 : [Patch] Fix random mkv or mp4 format when specifying resolution

• 2020.11.13 : [Patch] Added docker optinal variable to support youtube-dl proxy

• 2020.08.12 : [Patch] Added audio-mp3 option

• 2019.04.25 : [Patch] Failed to fetch jessie backports repository patch during build Dockerfile, Add Scheduler update "pip install -U youtube-dl" once a day.You no longer need to update pip youtube-dl when inexecutable in the container.

• 2020.04.07 : [Patch] Audio only option for web-ui and REST call. Change username field type for compatiblity

• 2020.02.10 : [Patch] Modifying so this will work behind HTTPS as well.

• 2019.02.13 : [Patch] binary excution error update, : 'caused by ExtractorError("Could not find JS function 'encodeURIComponent'; please report this issue onhttps://yt-dl.org/bug ..'. Binary Excution file update docker rebuild,Specify release version in html page

• 2018.11.08 : [Patch] binary excution error update, : 'youtube_dl.utils.RegexNotFoundError: Unable to extract Initial JS player signature function name'. some url like(https://youtu.be/), Handling Variables on Application Ports for Using the docker Network Host Mode,Specify release version in html page

• 2018.10.06 : [Patch] Prevent thread death due to websocket exception in walker thread after download, add REST API

• 2018.10.01 : [Minor Patch] Patching worker thread dead symptom when moving the browser during download, add resolution 1440p, 2160p(4k)

• 2018.09.28 : [Add functional option] Resolution selectable, Downloaded result html table representation**

The docker volume parameter-v is used by the queue operation to process the downloaded mount path to the host server

• downloaded docker volume path : '/downfolder'
• MY_ID, MY_PW : Required variables when you login validation, The start character '!' '$' '&' is does not apply.
• TZ : optional variable.

docker run -d --name youtube-dl -e MY_ID=modenaf360 -e MY_PW=1234  -v /volume2/youtube-dl:/downfolder -p 8080:8080 modenaf360/youtube-dl-nas

docker run -d --name youtube-dl -e TZ=Asia/Seoul -e MY_ID=modenaf360 -e MY_PW=1234 -v /volume2/youtube-dl:/downfolder -p 8080:8080 modenaf360/youtube-dl-nas

# use --net=host -e APP_PORT=custom_portdocker run -d --name youtube-dl --net=host -e APP_PORT=9999 -e MY_ID=modenaf360 -e MY_PW=1234  -v /volume2/youtube-dl:/downfolder modenaf360/youtube-dl-nas

curl -X POST http://localhost:8080/youtube-dl/rest \  -d'{"url":"https://www.youtube.com/watch?v=s9mO5q6GiAc","resolution":"best","id":"iamgroot","pw":"1234"}'

{"success": true,"msg":"download has started","Remaining downloading count":"7"}

If you want to get into docker container os, excute this command[1] :

docker exec -i -t youtube-dl /bin/bash

• docker volume mount setting

• ID, Password setting to docker environment

[1].https://docs.docker.com/engine/reference/commandline/cli/#environment-variables

This tool is based on yt-dlp and is providedsolely for personal and legitimate use in accordance with applicable laws. Users are responsible for complying with copyright laws, and downloading or distributing copyrighted material without permission from the rightsholder may violate applicable laws. This project does not encourage or support unauthorized use.

The developer bears no legal responsibility for any unauthorized or illegal use by users.