A cli to browse and watch anime — Italian fork that scrapes AnimeWorld for Sub ITA and Doppiaggio ITA.

⚠️ Fork italiano di pystardust/ani-cli: usa AnimeWorld al posto di allmanga, quindi trovi anime con sottotitoli e doppiaggio in italiano.

✨ ani-skip integrato: salto automatico di sigle iniziali e finali con --skip, senza installare nulla a parte (basato su synacktraa/ani-skip).

Table of Contents

• Risoluzione problemi
• Installazione
• Disinstallazione
• Dipendenze
  • Salto sigle
• FAQ
• Progetti simili
• Crediti
• Supporta il progetto
• Disclaimer

Quickstart (Arch)

Questo fork è uno script shell singolo (ani-cli). Dipendenze: curl, sed, grep, fzf, mpv (player) e aria2c (per il download). Su Arch:

sudo pacman -S --needed curl sed grep fzf mpv aria2

Poi installa lo script dal repo:

git clone https://github.com/nicolagalassi/ani-cli-it.git
cd ani-cli-it
sudo install -Dm755 ani-cli /usr/local/bin/ani-cli-it

Viene installato come ani-cli-it, così convive con l'ani-cli originale (inglese) eventualmente già presente. Aggiornamenti futuri: git pull + di nuovo sudo install ..., oppure ani-cli-it -U.

Uso

ani-cli-it <nome anime>        # ricerca interattiva, Sub ITA
ani-cli-it --dub <nome anime>  # Doppiaggio ITA
ani-cli-it -e 1-12 <nome>      # intervallo di episodi
ani-cli-it -c                  # riprendi dalla cronologia
ani-cli-it --last             # ultimi episodi usciti (Sub ITA)
ani-cli-it --last --dub       # ultimi episodi usciti (Doppiaggio ITA)
ani-cli-it -d -e 1 <nome>     # scarica invece di riprodurre
ani-cli-it -v <nome>           # usa VLC al posto di mpv

Sub ITA di default (voci senza badge DUB su AnimeWorld); con --dub solo i titoli doppiati in italiano.

Con --last sfogli gli ultimi episodi usciti dalla home di AnimeWorld (come i tab "Ultimi Episodi" del sito): la modalità segue sempre la distinzione sub/dub, quindi --last mostra il tab Sub-ITA e --last --dub il tab Dub-ITA. Selezioni l'episodio e parte direttamente.

Cambio di dominio di AnimeWorld

AnimeWorld cambia dominio abbastanza spesso. Se ani-cli-it smette di trovare risultati, di solito è perché il dominio è cambiato: aggiorna la riga animeworld_base="www.animeworld.ac" in cima allo script col nuovo dominio e reinstalla.

Per accorgersene in anticipo, il repo ha un controllo automatico (.github/workflows/domain-check.yml) che ogni 3 giorni verifica che il dominio risponda, non rediriga verso un dominio diverso e sia ancora funzionale. In caso di problema:

• apre una issue con i dettagli (e la richiude da solo quando torna tutto ok);
• se trova un dominio sostitutivo funzionante (dalla lista ufficiale o dal redirect), apre anche una Pull Request che aggiorna animeworld_base col nuovo dominio — così basta un merge per sistemarlo.

Puoi lanciare il controllo anche a mano:

.github/scripts/check-domain.sh          # usa il dominio corrente dello script
ANI_BASE=www.animeworld.tv .github/scripts/check-domain.sh   # prova un altro dominio

Risoluzione problemi

Aggiornamenti

All'avvio, ani-cli-it controlla in background (max una volta al giorno, senza rallentare la partenza) se sul repo è disponibile una versione più recente e, in tal caso, mostra un avviso tipo Aggiornamento disponibile: 4.15.0 -> 4.16.0. Per aggiornare:

ani-cli-it -U        # usa 'sudo ani-cli-it -U' se installato in /usr/local/bin

Per disattivare il controllo: export ANI_CLI_UPDATE_CHECK=0.

Se ottieni No results found (e sei sicuro che il nome fosse corretto) o un altro errore, assicurati prima di essere all'ultima versione con ani-cli-it -U. Se il problema persiste, apri una issue sul repository del fork.

Se AnimeWorld ha cambiato dominio (già successo in passato), aggiorna la riga animeworld_base="www.animeworld.ac" in cima allo script e reinstalla.

Installazione

Questo fork non è distribuito tramite package manager (apt/dnf/AUR/scoop/brew/pkg installerebbero l'originale inglese). Si installa da sorgente: è un singolo script shell.

Da sorgente (qualsiasi sistema unix-like)

Installa prima le dipendenze (vedi sotto), poi:

git clone "https://github.com/nicolagalassi/ani-cli-it.git"
sudo cp ani-cli-it/ani-cli /usr/local/bin/ani-cli-it
sudo chmod +x /usr/local/bin/ani-cli-it
rm -rf ani-cli-it

Installandolo come ani-cli-it convive con l'ani-cli originale eventualmente già presente. Se preferisci sostituirlo, copia in /usr/local/bin/ani-cli.

Dipendenze per piattaforma

Linux

• Arch: sudo pacman -S --needed curl sed grep fzf mpv aria2
• Debian/Ubuntu: sudo apt install curl sed grep fzf mpv aria2
• Fedora: sudo dnf install curl sed grep fzf mpv aria2 (per mpv serve RPM Fusion free: https://rpmfusion.org/Configuration)

Poi installa lo script da sorgente come sopra.

MacOS

Installa HomeBrew, poi le dipendenze:

brew install curl grep aria2 git fzf && brew install --cask iina

iina è un player per MacOS compatibile con mpv. Poi installa lo script da sorgente (puoi usare $(brew --prefix)/bin come destinazione).

Android (Termux)

Installa Termux, poi:

pkg up -y
pkg install curl sed grep fzf aria2 git

Come player usa la app mpv o vlc (Play Store / F-Droid). Su Android 14 installa anche termux-am. Poi installa lo script da sorgente.

Windows / WSL / iOS / Steam Deck / FreeBSD

⚠️ Non testato con questo fork. È lo stesso script POSIX dell'originale, quindi in teoria funziona se sono presenti le dipendenze (curl sed grep fzf mpv aria2 git), ma non posso garantirlo. Per la configurazione dell'ambiente (es. Windows Terminal + Git Bash, iSH su iOS, Konsole su Steam Deck) puoi seguire la guida dell'originale, ma clona da questo fork (non da pystardust). Se lo provi, apri una issue col risultato: aggiorno la doc di conseguenza.

Disinstallazione

sudo rm /usr/local/bin/ani-cli-it

La cronologia è salvata in ~/.local/state/ani-cli; per rimuoverla: rm -rf ~/.local/state/ani-cli.

Dipendenze

• grep
• sed
• curl
• mpv - Video Player
• iina - sostituto di mpv per MacOS
• aria2c - Download manager (per -d)
• fzf - Interfaccia utente
• ani-skip integrato (nessuna installazione separata; salta sigle OP/ED su mpv)
• patch - Auto-aggiornamento (-U)

Nota: rispetto all'originale, questo fork non usa openssl, yt-dlp o ffmpeg: AnimeWorld serve file mp4 diretti, quindi il download passa solo da aria2c.

Salto sigle (ani-skip integrato)

A differenza dell'originale, ani-skip è già integrato in questo fork: non devi installare nulla a parte. Usa --skip per saltare automaticamente sigla iniziale (OP) e finale (ED):

ani-cli-it --skip <nome anime>

Come funziona:

• L'ID MyAnimeList viene letto direttamente dalla pagina di AnimeWorld (più affidabile della ricerca per titolo, che fallirebbe sui titoli italiani).
• I tempi di salto arrivano dall'API di aniskip.
• Al primo uso viene installato in automatico un piccolo plugin lua di mpv in ~/.config/mpv/scripts/anicli-skip.lua.

Note:

• Funziona solo con mpv (usa lo scripting lua di mpv).
• Se l'anime non è riconosciuto o non ha tempi di salto, la riproduzione continua normale (nessun errore).
• Puoi forzare l'anime con --skip-title <mal_id> (un numero = ID MyAnimeList) oppure --skip-title "<titolo>" (ricerca su MyAnimeList via Jikan).

FAQ

Details

• Posso cambiare la lingua dei sottotitoli o disattivarli? - No, i sottotitoli sono incorporati nel video (hardsub).
• Posso guardare il doppiaggio? - Sì, usa --dub (se il titolo è disponibile doppiato in italiano su AnimeWorld).
• Posso cambiare la sorgente? - No, questo fork usa esclusivamente AnimeWorld.
• Posso usare VLC? - Sì, usa --vlc oppure export ANI_CLI_PLAYER=vlc.
• Posso scegliere la risoluzione? - No, AnimeWorld fornisce un unico file per episodio, quindi -q non ha effetto.
• Come scarico un episodio? - Usa -d, scarica nella cartella corrente.
• Posso cambiare la cartella di download? - Sì, imposta ANI_CLI_DOWNLOAD_DIR.
• Come scarico in blocco? - Usa -d -e primo-ultimo, es. ani-cli-it naruto -d -e 1-24.

Nota: tutte le opzioni sono documentate in ani-cli-it --help.

Homies

• animdl: Ridiculously efficient, fast and light-weight (supports most sources: allmanga, zoro ... (Python)
• jerry: stream anime with anilist tracking and syncing, with discord presence (Shell)
• anipy-cli: ani-cli rewritten in python (Python)
• mangal: Download & read manga from any source with anilist sync (Go)
• lobster: Watch movies and series from the terminal (Shell)
• mov-cli: Watch everything from your terminal. (Python)
• dra-cla: ani-cli equivalent for korean dramas (Shell)
• redqu: A media centric reddit client (Clojure)
• doccli: A cli to watch anime with POLISH subtitles (Python)
• GoAnime: A TUI tool to browse, play, and download anime in Portuguese and English, with Discord RPC, AniList integration, and intro skipping. (Go)
• Curd: A CLI tool to watch anime with Anilist, Discord RPC, Skip Intro/Outro/Filler/Recap (Go)
• FastAnime: browser anime experience from the terminal (Python)
• ani-skip: Automatically skip opening and ending sequences for IINA on MacOS (Typescript, official IINA plugin API)

Supporta il progetto

Se questo fork ti è utile, puoi offrirmi un caffè: aiuta a tenerlo aggiornato quando AnimeWorld cambia dominio o struttura. Grazie! ❤️

  

• Ko-fi: https://ko-fi.com/galax95
• PayPal: https://www.paypal.com/donate/?hosted_button_id=826CHYWWZFYBW

Crediti

• pystardust/ani-cli — progetto originale da cui deriva questo fork
• synacktraa/ani-skip — logica di salto sigle e plugin lua di mpv, qui reimplementati e integrati
• AnimeWorld — sorgente dei contenuti (Sub ITA / Doppiaggio ITA)
• aniskip API — tempi di OP/ED