Watch anime, series and movies from your terminal.

Kunai searches a title, resolves a stream a direct provider already serves, and hands playback to mpv — with YouTube, downloads, resume, and recovery in the same keyboard-driven session.

AnimeSeriesMoviesYouTubeTab cycles modes

Linux / macOScurl -fsSL https://kunai.kitsunekode.in/install.sh | bashWindowsirm https://kunai.kitsunekode.in/install.ps1 | iex
Get startedSee what it can doStar on GitHub37

From search to mpv in three steps.

One keyboard-driven session covers anime, series, movies, and YouTube — with providers, history, and recovery each one command away.

01

Search or continue

Find an episode, a film, or a YouTube video — or resume history, open the release calendar, and browse your offline library from the shell.

02

Resolve locally

Kunai asks registered adapters for a stream URL they already serve, then hands that URL to mpv.

03

Play in mpv

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

Everything stays one keystroke away.

  • Four catalog modes

    Series, anime, and YouTube each get their own mode. Tab cycles them; /anime, /series, and /youtube jump straight to one.

  • Direct providers

    12 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.

Installs active on 2026-10-01: 5 · lifetime 120 · usage analytics · opt out with /analytics

Direct adapters on your machine.

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

12 providers · 8 active

Kunai talks to third-party adapters on your machine. Registered adapters today: VidLink, Rivestream, AniDB, HiAnime, Miruro, AnimeGG, KickAssAnime, YouTube. They are unaffiliated and may break or disappear.

Provider guideFull provider table

Install

Install in three steps.

The preferred path is a self-contained binary, no Bun or Node required. Pick your OS for the exact bootstrap and mpv commands.

Step 01

Install mpv

Playback needs mpv on your PATH. The binary install embeds Bun, so Node and Bun are not needed separately.

sudo apt install mpv yt-dlp curl
Step 02

Install the Kunai binary

Downloads the release binary for Linux and puts kunai on your PATH.

curl -fsSL https://kunai.kitsunekode.in/install.sh | bash
Step 03

Set up, then search

Setup writes your config once. After that, the second command opens the shell on a real search.

kunai --setupkunai -S "Dune"

Other install paths

Already have Bun or Node? Install from npm instead.

bun install -g @kitsunekode/kunainpm install -g @kitsunekode/kunai

npm packagePrebuilt binariesBuild from source

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.

curl -fsSL https://kunai.kitsunekode.in/install.sh | bash
Get startedStar on GitHub37