anikoto-cli

A lightweight, colorful terminal app for watching and downloading anime directly from your command line.
It uses the Anikoto API (which aggregates content from multiple anime sources) to fetch search results, episode lists, and streaming links – no scraping or browser hassle required.

What it does (simply put)

Instead of juggling multiple tabs and ad‑blockers, anikoto-cli brings everything into your terminal.
You type a title, pick an anime from the search results, choose an episode and a server – and it either streams instantly with mpv (with auto‑skip for intros/credits) or downloads directly as a clean .mp4 file.

All data comes from the Anikoto API, which combines results from several anime websites behind the scenes, merges duplicates, and returns clean, ready-to-use links.

Powered by the Anikoto API

The CLI does not scrape any website directly. Instead, it communicates with the official Anikoto API:

• API endpoint: https://anikotoapi.fampep.workers.dev/
• The API aggregates multiple anime sources (sub/dub, various servers) and handles deduplication, mirror selection, and stream unpacking.
• This means anikoto-cli stays fast, lightweight, and never breaks due to DOM changes on third‑party sites.

Features

• Zero‑setup – automatically downloads ffmpeg if missing (Windows / macOS / Linux).
• Interactive menu – use arrow keys and Enter to navigate; no need to remember commands.
• Smart audio selection – picks the right audio track based on what the anime offers.
• Stream or download – choose on‑the‑fly for each episode.
• Auto‑skip engine – during playback, mpv chapters are scanned; intros, openings and endings are jumped automatically.
• Autoplay & resume – when an episode ends, the next one starts after a short countdown (press Enter to skip the wait). Close the player early and your progress is saved to a watchlist.

How to use

1. Install Node.js and mpv (mpv.io).
2. Install the CLI globally from npm:

   npm install -g anikoto-cli