← Directory

tdld

yt-dlp on a timer: polls three link lists (audio only, channels, playlists) and downloads new videos with yt-dlp and ffmpeg.

  • Downloaders
  • Media Applications
yt-dlp on a timer: polls three link lists (audio only, channels, playlists) and downloads new videos with yt-dlp and ffmpeg. A small web UI edits the lists, starts single downloads and shows the logs. A hotfolder converts dropped video files to mp3. For YouTube, put exported browser cookies into /config/ytdlpconfig/cookies.txt (see the project README).

Platform availability

Available on 1 of 6 install platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)

Also on GitHub

Health score

40/100 Fair

Maintained
72last commit 2 days ago
Popular
61 GitHub stars
Easy to install
201 install platform, Docker image
Light to run
No data

Based on 3 of 4 factors.

How is this calculated?

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). Factors without data are left out and the rest are rescaled.

Availability: platform listings confirmed today

GitHub stars
1
Open issues
0
Last commit
2026-10-04
Latest release
v2.0.0
License
MIT
Activity
rising

Checked today - source: GitHub (Tom-Joad/TDLD)

Resources & Compatibility

Requirements not published yet.

Checked today - source: Docker Hub image tags and published docs

First-install notes

No first-install notes yet.

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

No community discussions collected yet.