Yorumi CLI is the official command-line app for watching and downloading anime through Yorumi. It searches Yorumi when available, falls back to direct AllAnime scraping, opens mpv for playback, and writes MP4 downloads with AAC audio by default.
Downloaded MP4 files copy the video stream and convert audio to AAC for better compatibility with Windows Media Player. Use --copy-audio to preserve the source audio track.
Discovering Anime
Use --latest or --popular to explore new shows instead of searching.
Use --sub or --dub to prioritize subbed or dubbed audio streams.
yorumi-cli "Attack on Titan" --subyorumi-cli -e 1 "Attack on Titan" --dubyorumi-cli -r "1-5" "Attack on Titan" --subyorumi-cli -d -e 1 "Attack on Titan" --dub
Command Reference
-e, --episode <number>
Select a specific episode without prompting.
-r, --range <start-end>
Select an episode range such as 1-5.
-i, --anime-index <num>
Select a search result by index without prompting.
--sub, --dub
Prefer SUBbed or DUBbed audio streams.
-d, --download
Download selected episode(s) instead of opening mpv.
-o, --output <dir>
Choose a download directory.
-v, --version
Show the installed CLI version.
-l, --latest
Show the top latest updated anime.
-p, --popular
Show the top trending anime.
--direct
Request a direct stream URL when supported.
Update and Uninstall
yorumi-cli --updateyorumi-cli --uninstall
The updater pulls the latest GitHub repository revision and installs dependencies. The uninstaller removes the local install directory and known npm command shims.
Troubleshooting
mpv does not open
Install mpv, reopen your terminal, and run mpv --version. On Windows, the installer attempts to install mpv with Winget.
Fallback streams do not open
Install yt-dlp, reopen your terminal, and run yt-dlp --version. On Windows, the installer attempts to install yt-dlp with Winget.
ffmpeg is missing
Download mode requires ffmpeg. On Windows, Yorumi CLI can install it with Winget when needed.
Audio does not play in Windows Media Player
Run yorumi-cli --update. Current downloads convert audio to AAC by default.
Changelogs
Track Yorumi CLI releases, installer changes, and package-manager readiness.
v2.2.0
AniDB native scraper integration and ultra-fast standalone streaming.
Added & Changed
AniDB Native Scraper Integration: Integrated standalone AniDB scraper based on anidb.app (cross-referenced with ani-cli standards) as the primary search and streaming provider.
Ultra-Fast Standalone Streaming: Queries anidb.app suggestions and language endpoints directly using curl / fetch, providing direct 1080p, 720p, and 360p HLS playback in mpv without requiring a local Yorumi backend.
Resilient Fallback Hierarchy: Search and stream pipelines now query AniDB first, followed by AllAnime and AniNeko fallback providers if any source is unavailable.
Multi-Provider Fallback: Added standalone AniNeko stream scraper (src/anineko.ts) as a fallback provider when AllAnime streams fail or are missing for an episode.
Search Episode Ranking: Fixed episode calculation in backend-search.ts to prevent unreleased upcoming seasons (with 0 episodes) from being incorrectly scored and misranked above main released seasons.
Dynamic AES-256-GCM Key Scraping: Replaced static AllManga keys with dynamic runtime scraping of epoch, partB, and SvelteKit JavaScript chunks from mkissa.to to compute the AES-256-GCM key (aaKey), preventing static key expiration.
ani-cli Alignment & Endpoints: Updated timestamp-bucketed aaReq signature generation (seconds-based timestamp, epoch:queryHash:ts seed) and switched API requests to mkissa.net/api with mkissa.to Origin and Referer headers.
AllAnime Payload Decryption: Added multi-pass key candidates (SimtVuagFbGR2K7P, Xot36i3lK3:v1, allanime) and resilient slicing strategies to decryptTobeparsed() in both yorumi-cli and the main Yorumi backend scraper to prevent "No valid sources" failures across API payload rotations.
AllAnime Scraper: Updated AES-GCM and AES-256-CTR encryption keys for aaReq generation and tobeparsed decryption to restore streaming source retrieval after API changes.
Backend Sync: Synchronized the main Yorumi backend scraper to utilize the CLI's aaReq handshake mechanism.
AllAnime Scraper: Updated AES-GCM token generator to dynamically scrape keys from SvelteKit chunks to avoid static key rot.
Payload Decryption: Removed erroneous AES-GCM decryption for tobeparsed responses; AllAnime continues to return AES-256-CTR encoded responses with an appended garbage tag that is now safely discarded.
AllAnime Scraper: Updated AES-GCM decryption and request signature logic to handle AllAnime's new extensions.aaReq requirements and Cloudflare patches.
Standalone API resolution update to bypass deployed backend.
Added
Integrated native GraphQL queries to AllManga's API directly within the CLI.
Implemented built-in AES-256-CTR decryption for AllManga's encrypted stream payloads (tobeparsed).
Added custom hex decoding and automatic proxy redirect resolution to extract final playback URLs locally.
Fixed
Fixed critical 404 errors caused by relying on stale Vercel backend routes. The CLI is now fully self-sufficient and does not require the Yorumi backend to resolve streams.
