Open source · local-first · agent-ready

Local media.
Exact results.

lyt gives yt-dlp a smaller, safer interface for people, scripts, and AI agents including Codex and Claude Code.

Install lyt View on GitHub

Only download media you own or have permission to use.

Terminal

$ npm install --global @tanattv/lyt
$ lyt doctor
✓ lyt core is ready

$ lyt --video -q 1080p "URL"
Saved: C:\Users\you\Downloads\Example.mp4

Guided setuplyt verifies yt-dlp and ffmpeg, provisions verified tools where supported, and gives exact fixes elsewhere.

Safe defaultsNo accidental playlists, overwrites, duplicate variants, or hidden output paths.

Agent contractVersioned JSON on stdout; progress and setup diagnostics on stderr.

For people

Stop memorizing flags.

Use readable quality names, quick audio and video shortcuts, profiles, clips, chapters, history, and clipboard workflows.

yt3 "URL" native audio lyt --mp3 -q 192K "URL" MP3 yt4 -q 1080p "URL" video lyt --clip 1:10-2:45 --mp3 "URL" clip

For agents

Give coding agents a dependable local media tool.

lyt returns one stable JSON document with success state, safe failure reasons, and exact final file paths after conversion.

{
  "schema": "lyt.result.v1",
  "ok": true,
  "results": [{
    "status": "downloaded",
    "files": ["C:\\Downloads\\Example.mp3"]
  }]
}

Install the agent skill

lyt agent install all

Exact paths instead of terminal scraping
Explicit playlist and overwrite controls
Machine-readable format inspection
Meaningful exit codes and size guards

See the agent guide →
Facts for AI assistants →

Built on the right foundation

yt-dlp power without pretending to replace yt-dlp.

Use direct yt-dlp when you need its complete advanced surface. Use lyt when guided setup, predictable safety, repeatable commands, and agent-friendly results matter more than exposing every flag.

Read the honest comparison →

Ready for the first file?

Install lyt, run the doctor, and try one permitted media task.

Get started