ttdl
Installation
SKILL.md
ttdl — browser-native TikTok downloader
A thin browser-harness-js heredoc, exactly like gsearch/xsearch/ytdl.
There is no Bun program, no vendored signer, no HTTP client impersonation.
Every hard thing TikTok does to play a video — the signed CDN URL, the adaptive
quality ramp, the edit list — the page already does for playback. ttdl just
records the result. The capture is the clean, unwatermarked playback stream:
TikTok's in-app/Download button serves a separately rendered watermarked file,
while recording MediaSource gets exactly what the player shows the viewer.
ttdl "https://www.tiktok.com/@user/video/7642721752497310989" # best → ~/Downloads
ttdl "https://www.tiktok.com/@user/video/7642721752497310989" -q audio # audio only (.m4a)
ttdl "https://www.tiktok.com/@user/video/7642721752497310989" --info # title / author / duration / resolution
ttdl "https://vm.tiktok.com/ZMxxxxx/" # short link (browser resolves the redirect)
ttdl 7642721752497310989 # bare numeric ID
ttdl "https://www.tiktok.com/@user/video/..." -o Name -d ~/Videos