6.2 KiB
Kaizoku
A local web app to search, track, and download anime from Anikoto, AniNeko, and AnimePahe.
- Queue subbed or dubbed episodes and automatically download new releases.
- Organize shows in watchlists and save files in Jellyfin-friendly folders.
- Download available English subtitles and translate them to Czech with Ollama or OpenAI.
- Back up watchlists and receive Discord notifications.
The AI Subtitles page uses the same sidebar navigation and responsive layout as the other pages.
Jellyfin handoff checks each downloaded TV season in Finished separately, verifies its season-specific completion metadata, and moves only that season and its sidecars once its expected video files are present. Other seasons remain in Downloads. Use Config → Handoff → Run now after updating to repair missing or incorrect season metadata and retry previously skipped seasons. If metadata cannot be verified, the queue reports the skip and retains the files for a later retry.
Quick start
With Docker installed, run from this checkout:
docker compose up -d --build
Prebuilt image: gitea.coreplay.eu/dymas/kaizoku:latest (also tagged by release version). The Docker image uses a separate build stage for npm dependencies to keep the runtime image smaller.
Open http://127.0.0.1:8421/. For access from another device, set KAIZOKU_ALLOW_REMOTE=1, KAIZOKU_AUTH_USERNAME, and KAIZOKU_AUTH_PASSWORD before starting Compose.
For a local installation, install Python 3.12+, Node.js/npm, ffmpeg, and openssl, then run:
npm ci
./kaizoku
Keep .kaizoku/, backup/, downloads, and Jellyfin library folders when updating. .kaizoku/ contains configuration, watchlists, queue history, and other persistent state.
On the Queue page, choose 10, 25, 50, or 100 items per page beside the Previous and Next buttons. In Config → Watchlist management, use each list's Refresh checkbox to choose which lists are included in manual and scheduled bulk refreshes, then save the configuration. Watching and Planned are selected by default; custom lists can also be selected.
VPS login and Nginx Proxy Manager
Set these values in the .env file beside docker-compose.yaml before starting the container:
KAIZOKU_ALLOW_REMOTE=1
KAIZOKU_BASE_URL=https://tools.coreplay.eu/kaizoku
KAIZOKU_AUTH_USERNAME=your-admin-name
KAIZOKU_AUTH_PASSWORD=replace-with-a-long-unique-password
Keep .env private. Use Config → General to set the public base URL and login credentials instead, or edit base_url, auth_username, and auth_password in .kaizoku/config.json with Kaizoku stopped. Environment values take precedence. Config passwords are converted to salted scrypt hashes when settings are saved; a blank password field keeps the saved password. You can use /kaizoku as the base URL when the proxy supplies the public Host and X-Forwarded-Proto headers; the full HTTPS URL is recommended.
In Nginx Proxy Manager, use a proxy host for tools.coreplay.eu with a valid TLS certificate and Force SSL enabled. Add a Custom location /kaizoku pointing to Kaizoku's container/host on port 8421 over HTTP. Forward the request URI unchanged: no prefix stripping, rewrite, or trailing URI on proxy_pass is needed. Other locations on the domain can keep their existing backends. The equivalent Nginx location is:
location /kaizoku {
proxy_pass http://kaizoku:8421;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
Open https://tools.coreplay.eu/kaizoku/ and sign in. /kaizoku redirects to /kaizoku/; paths outside the mount return 404. After changing the base URL, reopen the app at the new address. Keep the backend port reachable only by the proxy (for example, on their shared Docker network or behind the VPS firewall).
Configured credentials protect pages and APIs even when the proxy connects over loopback. A configured public base URL without credentials denies access. New sessions last 12 hours, survive restarts, and use path-scoped HttpOnly/SameSite=Strict cookies with Secure for HTTPS. Sign out revokes that browser's session; changing credentials revokes existing sessions. Login forms require a valid CSRF value and login attempts are limited to 10 per socket peer per 15 minutes (clients behind one proxy share this limit; limits reset on app restart). API clients can use HTTP Basic authentication over HTTPS; browser mutations must have the public same-origin Origin header. The /kaizoku/status endpoint also requires authentication when login is configured.
An existing local installation without credentials and without a public base URL retains local-only access. Updates preserve all existing volumes and state; reuse the same mounts when moving the instance to the VPS.
Documentation
See the Kaizoku wiki for detailed instructions:
- Setup and configuration
- Docker and Jellyfin
- Downloads and watchlists
- AI subtitles
- Data safety
- Providers and upstream versions
Provider parsers are adapted from TheYogMehta/extensions. Bundled versions are Anikoto 6.0.0, AniNeko 4.0.0, and AnimePahe 6.0.1, checked on 2026-10-22. Anikoto retains Kaizoku search, dub detection, and stream patches; AnimePahe uses only the official .pw, .com, and .org mirrors with bounded search retries and bridge-compatible logging. Upstream hooks that require StrawVerse's browser or mapping database are inactive in Kaizoku.
Live source checks on 2026-10-17 returned Anikoto search results; AniNeko returned no matches and all three AnimePahe mirrors returned HTTP 403 from the test host. Current provider code does not guarantee source availability. Kaizoku does not host media.