ytfetch 1.1.0

A wrapper for yt-dlp with custom simple fetching flags

ytfetch

ytfetch simplifies media downloading and playlist management by adding "Smart Fetching,"playlist searching, and streamlined format handling on top of the powerful yt-dlp engine.

✨ Features

• Smart Fetching: Apply limits to multiple playlists or map specific ranges in a single download.
• Search: Use -list to display or search across single or multiple playlists contents.
• Direct Download: Single flag to download in legacy avc/h.264 and mp3 format and audio only extraction.
• Video Quality: Mention preffered video quality directly.
• Native Compatibility: Can also pass through any yt-dlp flag.
• Minimal Output logs: Clean and minimal logs.

📋 Requirements

• Python: 3.8 or higher.

• FFmpeg and FFprobe: Should available in your system PATH. Download builds from here

  or

  • On Windows:

    winget install BtbN.FFmpeg.GPL
    

    or

    winget install Gyan.FFmpeg
    

  • On Termux (android):

    pkg install ffmpeg
    

  • On Mac (using Homebrew):

    brew install ffmpeg
    

  • On Arch Linux:

    sudo pacman -S ffmpeg
    

  • On Ubuntu/Debian:

    sudo apt install ffmpeg
    

• Deno: Or other JavaScript runtime/engine like node.js or bun

  Check this guide for more info.

📦 Installation

via pip

pip install ytfetch

via source

git clone <your-repo-url>
cd <your-repo>
pip install -e .

🚀 Usage

General Syntax and Options

usage: Usage: ytfetch [yt-dlp OPTIONS] URL ... [OPTIONS]

options:
  -h                         Show this help message and exit.
  -help                      Show yt-dlp help message.
  -avcmp3                    Download video in AVC (h.264) format (mp4) + extract audio
  -q QUALITY                 Video quality (e.g., 1080, 720). Default is 1080.
  -mp3                       Extract audio only as MP3
  -audio                     Extract audio only
  -fetch RANGE [RANGE ...]   Alternate for --playlist-items. Single value applies globally
                             Multiple value must number of playlist URLs provided
                             match number of playlist URLs provided.
  -list [NAME]               List playlist contents. Accepts values for searching across playlist

Note: Arguments are position-independent except for -list and -flag where URLs can be mentioned after it

Examples

Basic Downloading

Download a video at the default quality (1080p)

ytfetch "VIDEO_URL"

Download a video in 720p

ytfetch "VIDEO_URL" -q 720

Format Conversion

Download as AVC(H.264) and Mp3 in MP4 Container

ytfetch "VIDEO_URL" -avcmp3

Extract Audio Only in Mp3

ytfetch "VIDEO_URL" -mp3

Smart Fetching

Global Limit

ytfetch "PLAYLIST_URL_1" "PLAYLIST_URL_2" -fetch "1-10"

Mapped Ranges

ytfetch "PLAYLIST_A" "PLAYLIST_B"  -fetch "1-5" "10-15"

Note: The number of fetch arguments must match the number of URLs

Listing and Searching

List a Playlist

ytfetch "PLAYLIST_URL" -list

Search through a playlist

ytfetch "PLAYLIST_URL" -list "remix"

Combined Fetch & Search

ytfetch "PLAYLIST_URL"  -fetch ":50" -list "search_word"

Passthrough Options

You can append any standard yt-dlp option to your command. Both long and short flags are supported.

Download via Proxy

ytfetch --proxy "socks5://127.0.0.1:1080" "VIDEO_URL"

Use Cookies

ytfetch --cookies "cookies.txt" "VIDEO_URL"

Limit Speed

ytfetch -r "500K" "VIDEO_URL"

🔖 License

MIT License