_{Fetch (icon) by Gregor Cresnar from Noun Project (CC BY 3.0)}

tugyt

is a lightweight command-line YouTube downloader powered by yt-dlp, with support for videos, playlists, audio extraction, subtitles, metadata, and download archives.

Install

Install the latest standalone release on macOS or Linux:

curl -fsSL https://raw.githubusercontent.com/ftnick/tugyt/main/install.sh | sh

On Windows, run this in PowerShell:

irm https://raw.githubusercontent.com/ftnick/tugyt/main/install.ps1 | iex

Restart the terminal after installation, then run tugyt --help.

Examples

Download a single video to the current folder:

tugyt "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

Download to a specific folder:

tugyt --output ./downloads "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

Download a playlist, but only a subset of items:

tugyt --output ./downloads --playlist-start 2 --playlist-end 10 "https://www.youtube.com/playlist?list=PL..."

Extract audio as MP3:

tugyt --extract-audio --audio-format mp3 --audio-quality 192K "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

List available formats without downloading:

tugyt --list-formats "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

Read URLs from a text file (one URL per line):

echo "https://www.youtube.com/watch?v=dQw4w9WgXcQ" > urls.txt
tugyt urls.txt

Uninstall

To uninstall on macOS or Linux:

curl -fsSL https://raw.githubusercontent.com/ftnick/tugyt/main/install.sh | sh -s -- --uninstall

On Windows, run:

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/ftnick/tugyt/main/install.ps1))) -Uninstall