🎌 anisama-cli

Also available in

A CLI to browse and stream anime from anime-sama.to — ani-cli style interface

✨ Fuzzy finder  •  🚀 One-command search  •  🇫🇷 VF/VOSTFR support  •  ▶ Auto next episode

---

Table of Contents

• 📦 Install
• 🎯 Usage
• ⚙️ Options
• 🗑️ Uninstall
• 📚 Dependencies
• ❓ FAQ
• 🌐 Similar Projects

---

Install

Ubuntu / Debian

# 1. Install system dependencies
sudo apt install git python3 python3-bs4 python3-requests mpv fzf

# 2. Clone and install
git clone https://github.com/can-oktay404/anisama-cli.git
cd anisama-cli
chmod +x anisama-cli
sudo cp anisama-cli /usr/local/bin/

Fedora

sudo dnf install git python3 python3-requests python3-beautifulsoup4 mpv fzf
git clone https://github.com/can-oktay404/anisama-cli.git
cd anisama-cli && chmod +x anisama-cli && sudo cp anisama-cli /usr/local/bin/

Arch Linux

# Via AUR
yay -S anisama-cli

macOS

brew install python mpv fzf git
pip3 install requests beautifulsoup4
git clone https://github.com/can-oktay404/anisama-cli.git
cd anisama-cli && chmod +x anisama-cli && sudo cp anisama-cli /usr/local/bin/

---

Usage

# Interactive search (recommended)
anisama-cli

# Direct search
anisama-cli naruto
anisama-cli "attack on titan"

# French dub (VF)
anisama-cli --vf "one piece"

# Continue from history
anisama-cli -c

# Help
anisama-cli -h

Flow

  Recherche › naruto
  ↓
  [fzf] Anime › Naruto / Naruto Shippuden / ...
  ↓
  [fzf] Saison › Saison 1 VOSTFR / Saison 1 VF / ...
  ↓
  [fzf] Épisode › Épisode 1 / Épisode 2 / ...
  ↓
  mpv launches fullscreen
  ↓
  Suivant › Épisode 2 ? [O/n]   ← auto next episode

---

Options

Option	Description
--vf	French dub (VF) only
-c, --continue	Resume from history
--debug	Verbose debug output
--check-services	Show which streaming service each anime uses
--available-only	List animes that work without VPN (Sibnet)
-h, --help	Show help

---

Uninstall

sudo rm /usr/local/bin/anisama-cli
rm -rf ~/.local/share/animesama-cli

---

Dependencies

Dependency	Purpose	Install
python3	Runtime	built-in on most distros
fzf	Interactive fuzzy selection	sudo apt install fzf
mpv	Video playback	sudo apt install mpv
python3-requests	HTTP requests	sudo apt install python3-requests
python3-bs4	HTML parsing	sudo apt install python3-bs4
yt-dlp	Optional — episode titles	sudo apt install yt-dlp

Note: sqlite3, re, os, sys are part of Python's standard library — no extra install needed.

---

FAQ

Some anime don't play / Vidmoly errors

Some anime (Naruto, Boruto...) use the Vidmoly streaming service which may be geo-blocked.

Solutions:

1. Try the VF version: anisama-cli --vf naruto (uses Sibnet, more reliable)
2. Use a VPN
3. Check which service an anime uses: anisama-cli --check-services

Can I watch with French voice?

Yes! Add --vf to your command:

anisama-cli --vf "one piece"

Where is my watch history stored?

In a local SQLite database: ~/.local/share/animesama-cli/history.db

Resume where you left off with anisama-cli -c.

Can I use VLC instead of mpv?

No. mpv is required for its HLS streaming support and command-line playback options.

Does it work on Windows?

Not officially supported. It requires fzf, mpv, and Python 3 — all available on WSL (Windows Subsystem for Linux).

---

Similar Projects

• 🇯🇵 ani-cli — Japanese/English subtitles
• 🇵🇹 GoAnime — Portuguese subtitles
• 🇩🇪 aniworld-cli — German streaming

---

⭐ Star this project if you find it useful!
Built by can-oktay404 — inspired by ani-cli