Commands And Shortcuts
Shell commands, playback shortcuts, overlays, and safe actions available across Kunai.
Kunai keeps the command palette context-aware. Press / in the shell to open the
available actions for the current screen. During playback, the same actions stay
available without losing the playing context.
Press ? in the shell for the full live help overlay. The table below is a
deliberately reduced public reference generated from the keybinding registry.
Personal Media Vocabulary
- Watchlist — built-in watch-later list (
/watchlist,/wl) - Playlists — durable named collections (
/playlists;/playlistand/plare aliases) - Up Next — current playback order (
/up-next;/queueis a compatibility alias) - Downloads — offline download jobs (
/downloads) - Follow / Unfollow / Mute — release attention, not saved-for-later state
- Provider — stable provider switching (
/provider)
Global Commands
/searchstarts a new search./historyopens recent playback progress./watchlistopens the built-in watch-later list./playlistsopens durable saved playlists./up-nextopens the current playback order./libraryopens the offline library with completed local downloads./play-localopens a file picker for local media playback./watch-onlinereturns from offline posture to online shell flows when network allows./downloadsopens active, queued, failed, and retryable download jobs./notificationsopens the notification inbox./provideropens the provider picker without changing provider until confirmed./follow,/unfollow, and/mutechange release attention for the current title./bookmarkadds or removes the current title from Watchlist./calendaropens release calendar results./discoverand/recommendationopen recommendation surfaces without autoplay./filtersopens guided search facets (type, year, library, and more)./sharecopies a catalog-anchoredkunai://play link to the clipboard./watchparses akunai://URL from the clipboard and launches playback.
/stats is on the default browse palette. Tracker sync is experimental and lives under
/settings → Sync. Random and surprise picks use the kunai --random launch flag or the
browse shuffle key — they are not typed slash commands today.
Playback Commands
/recoverrefreshes the active stream from the current provider and resumes./recomputebypasses stream cache and provider health memory for the current episode when source inventory looks stale./fallbacktries the next compatible provider when the active provider fails./replaystarts the current episode again from the beginning./sourceor/tracksopens the grouped media panel for source, quality, audio, hardsub, and subtitle facts./sourceand/qualityjump straight to those picker sections when they have switchable alternatives./pick-episode,/next,/previous, and/next-seasonnavigate episodes only when the target exists./downloadqueues the selected or active item for offline use after the required confirmation path./toggle-autoplay,/toggle-autoskip, and/stop-after-currentchange the current playback chain only.
Overlays
Help, diagnostics, settings, notifications, history, downloads, and provider pickers are overlays. They should not destroy the underlying playback or browse context. Close the overlay to return where you were.
Stable Hotkeys
| Context | Keys | Action |
|---|---|---|
| Global | / | Open command palette |
| Global | ? | Show this help |
| Global | Esc | Back · close panel · clear filter |
| While browsing | Tab / ⇧Tab | Cycle catalog mode forward (⇧Tab back): series / anime / YouTube |
| While browsing | Enter | Open the highlighted title |
| In the player | ⇧F | Switch to another provider (fallback) |
| In the player | m | Open title control menu |
| In the player | n / N | Next episode |
| In the player | p / P | Previous episode |
| Global | ⌃C | Quit |
| While browsing | i | Show title details |
| While browsing | ⌃O | Show title details |
| While browsing | ⌃D / d | Download the highlighted title |
| While browsing | q | Add the highlighted title to Up Next |
| While browsing | w | Add the highlighted title to Watchlist |
| While browsing | f | Favourite or unfavourite the highlighted title |
| While browsing | ⇧W | Follow releases for the highlighted title |
| While browsing | ⌃T | Reload trending results |
| While browsing | ⌃F | Narrow loaded results |
| While browsing | m | Open starting-point menu for the highlighted title (same as Enter) |
| While browsing | ⇧Q | Open Up Next |
| In the player | q | Stop playback |
| In the player | o | Choose source |
| In the player | e | Choose episode |
| In the player | l | Favourite or unfavourite the current title |
| In the player | b | Skip intro / recap / credits (when offered) |
| In the player | s | Reload subtitles |
| In the player | ⇧S | Return to search |
| In the player | a | Toggle autoplay |
| In the player | u | Toggle autoskip |
| In the player | x | Stop after current episode |
| In the player | d | Open diagnostics |
| In the player | k / K | Choose quality (in the terminal; v in mpv) |
| In the player | ⌃R | Refresh the stream (same episode) |
| In the player | Alt+R | Resume to your saved position |
| After playback | n | Continue / next |
| After playback | r | Replay this episode |
| After playback | s | Search for something else |
| After playback | ⇧F | Switch to another provider (fallback) |
| After playback | o | Choose source |
| After playback | e | Choose episode |
| After playback | m | Open title control menu |
| Stats | Tab / ⇧Tab | Next / previous stats tab (Overview · Titles · Insights) |
| Stats | r / ⇧R | Cycle range forward / back (All time · Last 7d · Last 30d) |
| Stats | ←→ | Cycle media type forward / back (All · Anime · Series · Movies · YouTube) |
45 stable shortcuts from the keybinding registry. Press ? in the shell for the full live help overlay.
Locked chords worth calling out:
Tabcycles browse catalog mode (series / anime / YouTube).- Provider fallback during playback is
⇧F(Shift+F). Barefis not bound. - During playback, live
mopens the title control menu. The memory panel is/memory, not a competing bare-key binding.
Reporting Problems
Use /diagnostics first, then /export-diagnostics when you need a redacted
support bundle. Use /report-issue to open the GitHub issue page.
Opening Docs
Use /docs to open the documentation website. Development builds can point this
to a local or preview deployment with KUNAI_DOCS_URL.
For the full generated command list, see Feature tour. Launch flags are documented in CLI reference.
Last updated on