Share Links
Copy browser-safe Kunai links, show a terminal QR, and open HTTPS, compact, or kunai:// handoffs across machines and providers.
Kunai shares browser-safe https://kunai.kitsunekode.in/w/<code> links. The web page shows what was shared, offers an Open in Kunai handoff, and gives native install commands to someone who does not have Kunai yet. Links remain anchored to catalog metadata (TMDB, AniList, MAL, IMDb), so the receiver resolves through their own providers instead of repeating a title search.
The URL contains the playback ref itself. There is no shortener database. Share-page events are excluded from both site analytics and performance telemetry, including samples delivered after you navigate away. Anyone holding the URL can read the title and episode it contains.
Protocol handler is Linux-only
kunai --open works on every platform without OS registration. kunai --install-protocol-handler
registers the kunai:// OS handler on Linux only in 0.3.0.
Copy a link from the shell
During or after playback:
/shareCopies a catalog-anchored HTTPS URL to your clipboard. When resume position exists, Kunai can include a timestamp (t=) so the receiver starts near where you left off.
To show a scannable HTTPS QR inside the terminal while copying the full link:
/share --qrThe QR uses a compact, checksummed catalog code. It intentionally omits display-only title and provider hints to stay readable in ordinary terminal sizes; the catalog, episode, and timestamp remain exact.
From mpv while playing:
- Ctrl+Shift+S: copy link at the current
time-pos
Post-playback and History rows also expose Share link / Copy share link actions.
Open a link from the shell
/watchReads an HTTPS URL, a kunai:// URL, or a compact k1… code from your clipboard, resolves it against your local catalog and providers, and launches mpv with any shared timestamp applied once on the first play.
Launch from the terminal
Trusted open (no confirmation prompt):
kunai --open "kunai://play?cat=tmdb%3A438631&kind=movie"Register the OS protocol handler (Linux-only in 0.3.0):
kunai --install-protocol-handlerAfter registration on Linux (including WSL), kunai:// links from browsers or chat apps route through --handoff-url, which may ask for confirmation. On macOS and Windows-native, keep using kunai --open. A WSL registration does not cover Windows-native browsers outside WSL.
URL shape
The copied form is HTTPS:
https://kunai.kitsunekode.in/w/v1.<encoded-ref>The application handoff inside that page keeps the existing grammar:
kunai://play?cat=<namespace>:<id>&kind=<movie|series|anime|video>&s=<season>&e=<episode>&t=<seconds>
kunai://download?... # same query params; queues a download instead of playback
kunai://play?q=<query>&kind=... # search fallback when no catalog id is known| Parameter | Meaning |
|---|---|
cat | Catalog anchor: tmdb:, anilist:, mal:, imdb:, or youtube: namespace + id |
q | Search query fallback (use instead of cat when no stable id) |
kind | movie, series, anime, or video. Optional, but write it: a link without it is read as series even when the namespace says otherwise |
s / e | Season and episode (1-based) |
t | Start offset in seconds, 1m23s, or 1:23 |
src | Optional provider hint |
sq | Optional quality hint |
Examples
kunai://play?cat=tmdb%3A1396&kind=series&s=1&e=3
kunai://play?cat=anilist%3A21&kind=anime&s=1&e=1&t=120
kunai://play?q=One%20Piece&kind=animeCatalog targets also have a checksummed compact form such as k1pts.1396.1.3.…. Search fallback links do not: Kunai never turns a direct catalog target into the slower q= path merely to shorten it.
Timestamp resume
Shared t= applies once on the first mpv launch (max of shared timestamp vs local history). Normal per-episode resume takes over afterward.
Discord presence
Rich Presence can show an https catalog button. Playable kunai:// refs may appear in presence text; Discord buttons only allow http(s) URLs.
Last updated on
Continue Watching and New Episodes
How Kunai reconciles watch history, decides what counts as a new episode, raises notifications, and keeps your continue-watching list accurate over time.
Downloads and Offline
Queue Kunai downloads, play local files, manage the offline library, clean up finished jobs, and diagnose a download that stalled or failed to resume.