n8n-nodes-ytdlp
v0.1.5
Published
n8n community node for yt-dlp – download videos and audio from 1000+ websites
Maintainers
Readme
n8n-nodes-ytdlp
An n8n community node that integrates yt-dlp — a powerful command-line tool to download videos and audio from 1000+ websites including YouTube, Twitter/X, TikTok, Bilibili, and many more.
Prerequisites
yt-dlp must be installed on the machine running n8n.
Install yt-dlp
# via pip (recommended)
pip install yt-dlp
# or download the binary directly (no Python required)
# https://github.com/yt-dlp/yt-dlp/releases/latestVerify the installation:
yt-dlp --versionOptional dependencies (for full functionality)
# For merging video+audio streams (highly recommended)
# Windows: download from https://ffmpeg.org/download.html
# Linux/Mac:
apt install ffmpeg # Debian/Ubuntu
brew install ffmpeg # macOSInstallation
Via n8n UI (Recommended)
- Go to Settings → Community Nodes
- Click Install
- Enter:
n8n-nodes-ytdlp - Click Install
Via CLI
# In your n8n installation directory:
npm install n8n-nodes-ytdlpOperations
| Operation | Description | |-----------|-------------| | Get Info | Retrieve video/playlist metadata as JSON (no download) | | List Formats | List all available download formats for a URL | | Download | Download video/audio to a local directory | | Extract Audio | Download and extract audio in a specified format (MP3, M4A, etc.) |
Parameters
| Parameter | Operations | Description |
|-----------|------------|-------------|
| URL | All | Video or playlist URL |
| yt-dlp Binary Path | All | Path to the yt-dlp binary (default: yt-dlp) |
| Output Directory | Download, Extract Audio | Local directory to save files |
| Format | Download | yt-dlp format selector string |
| Audio Format | Extract Audio | MP3, M4A, AAC, Opus, FLAC, WAV |
| Audio Quality | Extract Audio | VBR quality 0–9 (0 = best) |
| Flat Playlist | Get Info | List playlist entries without full metadata |
| Cookies File | All | Path to a Netscape cookies.txt for authentication |
| Proxy URL | All | HTTP/SOCKS5 proxy URL |
| Additional Arguments | All | Extra raw yt-dlp CLI arguments |
Example Workflows
Get video metadata
- Add yt-dlp node → Operation: Get Info
- Enter URL → execute
- Output contains
title,duration,thumbnail,formats, etc.
Download best MP4
- Add yt-dlp node → Operation: Download
- Set Output Directory to
/tmp/videos - Format:
bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best
Extract MP3 audio
- Add yt-dlp node → Operation: Extract Audio
- Audio Format:
mp3, Quality:5
Resources
License
This node package is released under the Unlicense.
yt-dlp itself is also released under the Unlicense.
