TDLD
TDLD is a self-contained yt-dlp container for self-hosted media collection that automatically downloads new videos from managed audio, channel, and playlist…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
46/100 Fair
- Maintained
- 77last commit 24 days ago
- Popular
- 61 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today
- GitHub stars
- 1
- Open issues
- 0
- Last commit
- 2026-10-28
- Latest release
- v3.0.4
- License
- MIT
- Activity
- rising
Checked 23 days ago - source: GitHub (Tom-Joad/TDLD)
Resources & Compatibility
Requirements not published yet.
Checked 46 days ago - source: Docker Hub image tags and published docs
First-install notes
- YouTube cookies For YouTube downloads, put exported browser cookies into /config/ytdlpconfig/cookies.txt. source
- Application setup Configure the audio-only, channel, and playlist link lists in the web UI to enable automatic downloads. source
Fetched 43 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What folders should I mount for TDLD and where are the download lists stored?
Map a folder to /config and another to /downloads. The download lists are in /config/lists as audioonly, channels, and playlists list files, one URL per line.
What port is the TDLD web UI on and what can it do?
The web UI runs on port 8083. It lets you edit the link lists, start a single download, and read the logs.
How do I reduce YouTube "Sign in to confirm you're not a bot" errors?
Put your YouTube cookies in /config/ytdlpconfig/cookies.txt. The image also uses quickjs to handle YouTube JS challenges automatically, but cookies are the important manual mitigation.
How does the TDLD hotfolder work?
TDLD watches /hotfolder and converts dropped video files to .mp3 on a timer. The hotfolder contains input, output, and processed directories.
Where does TDLD keep the records that prevent duplicate downloads?
It stores yt-dlp download archives in /config/archives so content is not downloaded twice.
Answers sourced from github.com
Community
Collected 44 days ago - public community threads