$ npx zahori get https://example.org/live
https://cdn.example.org/hls/live/master.m3u8

No per-site configuration. No extractor to wait for. If a browser can play it, zahori can find it.

Table of contents

• Features
• Why zahori
• Install
• CLI
• Library
• Profiles: how zahori learns a site
• Teaching zahori a site
• The oracle
• Responsible use
• API
• Documentation
• Contributing
• License

Features

• Works on any URL, out of the box. A built-in generic flow handles most pages with zero config.
• Real browser engine. Playwright drives a headless browser in the background; consent banners, play buttons and iframe players are handled automatically, in several languages.
• Replay headers included. Referer/Origin/UA/Cookie are captured from the real request, so ffmpeg and friends don't get 403'd.
• HLS-aware. Master vs media playlists, live vs VOD detection, and audio-rendition selection by language for multilingual streams.
• Learnable. Tricky sites become a small JSON profile, saved once, deterministic forever.
• Agent-native (MCP). Your coding agent can probe a site, author a profile, test it and save it.
• Self-healing. zahori heal repairs a profile when the site changes, using a BYO-key model, verified by an objective oracle before anything is saved.
• DRM-refusing by design. Protected content is detected and rejected, always.

Why zahori

The long tail of the web streams through embedded players that no downloader knows: local TV and radio stations, live event pages, small video portals. yt-dlp is superb for the big platforms it curates extractors for. But the long tail has no extractor, and hand-writing one per site doesn't scale.

They are complementary: use yt-dlp for YouTube, use zahori for the page nobody wrote an extractor for.

Install

npm install -g zahori   # CLI
npm install zahori      # library

Requirements

pnpm users: pnpm blocks dependency build scripts by default, so Playwright won't auto-download a browser. Run the playwright install line above once, or your system Chrome is used as a fallback.

CLI

# Resolve the stream URL behind a page (URL to stdout, everything else to stderr)
zahori get https://tv.example.org/live

# Full result as JSON: url, kind, live/VOD, replay headers, all candidates
zahori get https://tv.example.org/live --json

# Prefer an audio language on multilingual streams
zahori get https:/

... [View full README on GitHub](https://github.com/josesepulvedapino/zahori#readme)