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.

Copy a link and run lyt. Use readable quality names, profiles, clips, chapters, history, and clipboard watch when you need more.

lyt clipboard link lyt "URL" native audio lyt --mp3 -q 192K "URL" MP3 lyt --video -q 1080p "URL" video

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