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…

  • Downloaders
  • Media Applications
TDLD is a self-contained yt-dlp container for self-hosted media collection that automatically downloads new videos from managed audio, channel, and playlist lists, and provides a web user interface for list edits, single downloads, logs, and MP3 conversion of hotfolder video files.

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

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