Terminal-first playback

Kunai — a calm command shell for playable streams.

Search your catalog, resolve a direct stream on your machine, hand playback to mpv, and recover without restarting when something stalls.

curl -fsSL https://raw.githubusercontent.com/KitsuneKode/kunai/main/install.sh | bashGet startedBrowse docs
Windowsirm https://raw.githubusercontent.com/KitsuneKode/kunai/main/install.ps1 | iex

Install

Get started in three steps.

Preferred path is a self-contained binary (no Bun or Node required). Select your OS for the exact bootstrap and mpv commands.

Step 01Prerequisites

Install dependencies

Playback needs mpv on your PATH. The binary install embeds Bun — you do not need Node or Bun separately.

sudo apt install mpv yt-dlp curl
Step 02

Install Kunai shell

curl -fsSL https://raw.githubusercontent.com/KitsuneKode/kunai/main/install.sh | bash
Step 03

Initialize configuration

kunai --setup

From search to mpv in three steps.

Kunai keeps the shell readable while providers, history, and recovery stay one command away.

01

Search or continue

Find a title, resume history, or open calendar, recommendations, or your offline library from the shell.

02

Resolve locally

Kunai checks provider health, resolves a direct stream, and keeps source inventory in SQLite before mpv starts.

03

Play in mpv

The shell supervises playback, resume offers, auto-skip, and post-play routing when the session ends or stalls.

Built for daily playback, not demos.

  • Direct providers

    7 provider modules resolve streams on your machine. No browser automation and no shared relay by default.

  • Continue watching

    History, calendar, recommendations, and offline downloads stay one command away after playback ends.

  • Recovery built in

    Recover, recompute, and fallback each handle a different stall, with diagnostics that stay redacted by default.

Direct adapters on your machine.

Kunai resolves streams locally. See the provider guide for status, capabilities, and setup notes.

7 providers · 4 active

Kunai resolves streams through direct HTTP adapters on your machine. Recommended defaults today: Videasy, VidLink, Rivestream, AniDB, YouTube.

Provider guideFull provider table

Pick the guide that matches your next step.

Getting started
Install Kunai and mpv, run setup, and launch your first playback session.
What you can do
See the daily shell workflows for search, playback, downloads, and recovery.
Troubleshooting
Fix stalled streams, provider failures, and setup issues with symptom-first steps.
CLI reference
Browse the full command list, launch flags, and provider tables synced from the CLI.

Install once, then keep playback predictable.

Recovery stays in the shell. No shared public relay — when you need geo metadata help, you own the relay URL.

Get startedBrowse docs