Install

From zero to a saved file.

lyt requires Node.js 20 or newer. It can fetch verified yt-dlp binaries automatically. On Windows it can also provision ffmpeg; on macOS and Linux, lyt doctor provides the correct package-manager command.

1. Install the CLI

npm install --global @tanattv/lyt

2. Check your capabilities

lyt doctor

The doctor separates required core tools from optional capabilities such as MP3/video processing and clipboard integration.

3. Download one permitted item

Native audiolyt --audio "URL"

MP3 · 192Klyt --mp3 -q 192K "URL"

Video · 1080plyt --video -q 1080p "URL"

Where does the file go?

By default, lyt saves to a downloads folder under the current working directory and prints the exact final path. Choose another location with -o "D:/Media".

Common first-run fixes

Confirm node --version is 20 or newer.
Run lyt doctor --fix only after approving managed tool installation.
Quote every URL so the shell does not interpret special characters.
Use --dry-run to preview a job without installing or downloading.
Open a GitHub issue without sharing cookies, private URLs, tokens, or personal paths.

Open npm package Get help