@dgxo/ytdlp

CLI shortcut wrapper for yt-dlp — download videos & audio from hundreds of sites with dead-simple commands.

This package is a shortcut/wrapper layer built on top of yt-dlp. All downloads are powered by yt-dlp under the hood. yt-dlp is licensed under The Unlicense.

Install

npm i -g @dgxo/ytdlp

First time setup

dlp --install

Auto-installs yt-dlp, ffmpeg, and deno.

• Windows → tries winget first, falls back to direct binary download
• Linux → asks your distro (Arch, Ubuntu, Debian, Fedora, openSUSE)

Commands

⚙ Setup

dlp --install          # Install yt-dlp, ffmpeg & deno
dlp --checkinstall     # Check if all dependencies are installed

🎬 Video

dlmp4  <url>           # Best MP4
dlmkv  <url>           # Best MKV
dlbest <url>           # Highest quality (any format)
dl4k   <url>           # Max 4K MP4
dl1080 <url>           # Max 1080p MP4
dl720  <url>           # Max 720p MP4
dl480  <url>           # Max 480p MP4

🎵 Audio

dlmp3  <url>           # MP3
dlaac  <url>           # AAC
dlflac <url>           # FLAC (lossless)
dlwav  <url>           # WAV
dlopus <url>           # Opus
dlaudio <url> [fmt]    # Any format: mp3/flac/wav/aac/opus

📋 Playlist

dlplaylist    <url>    # Full playlist as MP4
dlplaylistmp3 <url>    # Full playlist as MP3

✨ Features

dlclip    <url> <start> <end>   # Clip a section (e.g. 00:01:00 00:02:30)
dlsponsor <url>                 # Skip sponsor segments (SponsorBlock)
dlsub     <url> [lang]          # Embed subtitles (default: en)
dlautosub <url> [lang]          # Embed auto-generated subtitles
dlchapters <url>                # Split video by chapters
dllive    <url>                 # Download livestream from start
dlthumb   <url>                 # Download thumbnail only
dlbatch   <file.txt>            # Batch download from URL list

🔍 Info

checkmp4   <url>    # List all available formats
checkmp3   <url>    # List audio-only formats
checksub   <url>    # List available subtitles
checkthumb <url>    # List available thumbnails
checkinfo  <url>    # Show video info (title, views, duration...)

🔧 Utility

dlupdate               # Update yt-dlp to latest version

Requirements

• Node.js 18+
• yt-dlp, ffmpeg, deno — auto-installed via dlp --install

License

MIT