Table of Contents
Downloads and Watchlists
The Watchlist search filters entries before pagination, including matches in provider titles and custom library names. It searches the selected category; choose All categories to find a show anywhere. Clearing the search restores the unfiltered list. Category counts and the overall summary still reflect every tracked show.
The Watchlist Auto-download dialog's custom name and season control the final library path: for example, name My Series and season 3 produce tv/My Series/Season 03/My Series - S03E01.mp4. The source title continues identifying the provider anime. Saving these settings also updates unstarted pending downloads linked to that anime; save again after upgrading to apply them to existing pending jobs. Running jobs and retries with completed episodes keep their original layout, and existing files are not moved or renamed automatically. A custom library name entered in Search is retained when adding the result to the watchlist.
Anikoto searches use the site's filter endpoint, which supports paginated queries. When Anikoto returns HTTP 500 for a query, Kaizoku retries with the lowercase phrase and then its first meaningful word. The fallback results may be broader than the original phrase. If a provider remains unavailable, Search shows a temporary-unavailability message instead of an unexpected application error. AnimePahe checks each of its configured mirrors once per search, so a blocked API does not cause repeated wait cycles.
Kaizoku stores provider-backed show IDs as provider:id, for example anikoto:some-show-slug. Queue jobs resolve the episode source through providers/bridge.js, then provider_downloader.py downloads the media with ffmpeg into a staging directory. If a provider returns multiple servers for the requested sub or dub mode, Kaizoku tries every same-mode server source in quality order before falling back to another provider, including when resolving one server's playlist raises an HTTP error. It does not use sub sources for dub downloads, or dub sources for sub downloads. If a provider returns a master HLS playlist, Kaizoku selects the highest-bandwidth variant before starting ffmpeg. When a media playlist uses extensionless, SnapCDN, or disguised CDN segments, Kaizoku skips direct ffmpeg and uses a StrawVerse-style segment downloader; if HLS preflight fails, it stays on that native path instead of falling through to ffmpeg. The native downloader fetches the media playlist, preserves provider CDN session cookies across playlist, segment, and encryption-key requests, downloads and concatenates segments itself with browser-like media headers and the provider referer, can fall back to curl-impersonate browser wrappers after protected CDN HTTP 403 responses, strips short PNG wrappers when present, retries temporary HTTP failures such as 429 Too Many Requests, optionally paces requests with KAIZOKU_SEGMENT_DOWNLOAD_DELAY, then remuxes the local transport stream to MP4. Direct ffmpeg attempts also have a timeout guard so stalled HLS inputs can fall back cleanly. Each episode is written as a temporary .mp4.part file and moved into the downloads library after that episode succeeds, so already-finished episodes from a larger batch survive if a later episode fails. Retrying that failed queue job requests only the remaining episodes while keeping the original episode range for display and watchlist sync. Finalization preserves episode numbers from staged SxxEyy or Episode yy filenames before applying configured season/episode offsets.
Provider bridge subprocesses time out after 120 seconds by default. Watchlist refreshes apply their shorter request timeout to each metadata and episode-list call, so an unresponsive bridge can fail and allow subsequent work to continue. Fractional episode numbers such as 12.5 keep distinct filenames instead of colliding with episode 12.
Provider server aliases that resolve to the same URL and request headers are downloaded only once, avoiding duplicate CDN requests and unnecessary rate limiting.
When the selected source exposes English external subtitle tracks, Kaizoku saves the first successfully fetched track alongside the video as .eng.vtt, .eng.srt, .eng.ass, or .eng.ssa. Subtitle requests use provider/track headers, session cookies, retries, and the media HTTP fallback. Subtitles move into the library with each completed video and keep matching filenames after custom naming, season/episode offsets, or filename collisions. Subtitle failures do not fail an otherwise completed video; the queue log reports failed tracks or that no English external track was exposed. Burned-in subtitles cannot be saved as a separate file, and Kaizoku does not extract embedded or HLS-playlist-only subtitle tracks. The bundled AnimePahe adapter currently exposes no external subtitle tracks.
For older videos, open the series card in Watchlist and choose Download all → Subtitles only. Kaizoku checks the selected season in its Downloads folder and the configured Jellyfin TV or movie folder (including Season 1 and Season 01 layouts), queues only existing videos without English or untagged subtitle sidecars, and tries available sub and dub provider streams for English external tracks. It saves a sidecar with the exact video basename, such as Old Show - S01E01.eng.srt, without changing the video, existing subtitles, watchlist download state, or sending a video-download notification. TV filenames must identify an episode using S01E01, Episode 1, or - 01 style numbering; movie folders must contain one video. The watchlist library name, season, and episode offset must match where the older files live. A job with no available external English tracks reports a failure in the Queue log; partially available tracks are saved and skipped episodes are listed there. If Refresh after handoff is enabled and a subtitle lands in Jellyfin, Kaizoku requests the same configured library refresh. Subtitles already embedded or burned into a video cannot be extracted by this action.
If the primary provider cannot list, resolve, or download a requested episode, Kaizoku searches the selected provider's title on the remaining providers and tries the matching episode there. A custom library name is used only for output naming. Fallback requires a unique normalized title match, retaining season, part, and cour labels; equivalent notation such as Season 2 and 2nd Season is accepted. Shared words or a matching title prefix are insufficient. Ambiguous results, different seasons, and titles that cannot be verified (including alternate translations) are skipped. If no matching source succeeds, the job fails while preserving completed episodes. This prevents unavailable later-season episodes from being silently replaced with season 1 episodes; it does not identify or repair previously downloaded incorrect files. Existing finalization code moves staged files into the configured library layout, preserving data already present in production download folders. If a library move fails, the queue reports failure and leaves remaining completed files in the staging folder shown in the job log for manual recovery. Resolve the storage/permission problem and recover those files before retrying the download.