Runtime Feedback

Kunai keeps normal playback calm, then exposes runtime feedback when it helps you understand a slow provider, a buffering stream, or a possible memory issue.

During playbackCopy Anchor Link

• Press /memory while playback is active to reveal the memory strip.
• By default, the strip is hidden and temporary.
• If the memory panel setting is enabled, /memory pins it until you run /memory again.
• Live m during playback opens the title control menu, not the memory strip.
• Open /diagnostics for the full runtime health view.

The memory line separates Kunai from the player:

• App is the Kunai process RSS.
• mpv is the direct child player RSS when the platform exposes it.
• total is app plus player RSS.
• heap is the JavaScript heap used and reserved by Bun.
• swap appears only when the platform reports swap usage.

On Linux, Kunai reads /proc to include the direct mpv child. On platforms without /proc, the app memory remains available and player memory may show as 0.0 MiB.

Memory trend is a short-lived, in-process sample window. It is not written to the data DB and it resets when Kunai exits. stable means recent movement stayed inside the normal noise band, while growing means RSS or heap climbed quickly enough to deserve attention.

Network and provider feedbackCopy Anchor Link

The playback shell and Diagnostics panel summarize the latest mpv and provider events:

• Network shows cache speed, buffer-ahead seconds, stalls, and same-stream reconnect attempts.
• Provider shows the resolved provider, cache hits, stream counts, subtitle counts, and typed failures.
• Cache explains whether Kunai used a fresh stream, refreshed a stale stream, or kept a cached fallback.

Use /export-diagnostics when a session behaves strangely. The bundle is redacted and stays local until you choose to share it.

When to investigate memoryCopy Anchor Link

Memory is worth checking when:

• The app stays open across many titles and RSS only climbs.
• mpv remains non-zero after playback stops.
• Swap appears in the runtime line.
• Memory trend stays growing after several diagnostic checks.
• The terminal becomes slow while provider/network health looks normal.

If you report this, include the /diagnostics output, the exact command you ran, platform details, and whether artwork previews or downloads were enabled.