animesama 1.0.20

Browse and watch anime from anime-sama.fr directly in your terminal

animesama-cli

Browse and watch anime from anime-sama.si directly in your terminal.

Demo

Overview

animesama-cli is a terminal application for browsing and watching anime from anime-sama.si. It provides catalog search, persistent watch history, and the weekly release schedule. Video playback is handled by mpv.

Features

• Full-text search of the anime-sama catalog
• Interactive TUI built with Textual, with a standard CLI fallback
• Watch history stored in SQLite, with resume support
• Weekly release schedule from anime-sama
• Upcoming episodes from animecountdown.com
• French dub (VF) and Japanese audio with French subtitles (VOSTFR)
• Linux and Windows support; AUR package available for Arch Linux

Installation

Every release is automatically published to all of these package managers:

Platform	Package manager	Install command
Debian / Ubuntu	apt (own repository)	sudo apt install animesama-cli
Fedora / RHEL	dnf (own repository)	sudo dnf install animesama-cli
Arch Linux	AUR	yay -S animesama-cli
macOS	Homebrew	brew install Miro-sh/tap/animesama
Any Linux / macOS	pipx (PyPI)	pipx install animesama
Windows	Install script	See below

The apt/dnf packages and the Homebrew formula pull in mpv and Python automatically. With pipx, install mpv through your package manager first.

Debian / Ubuntu

Add the GPG key and the repository, then install:

curl -fsSL https://miro-sh.github.io/animesama-cli/animesama.gpg | sudo gpg --dearmor -o /usr/share/keyrings/animesama.gpg
echo "deb [signed-by=/usr/share/keyrings/animesama.gpg] https://miro-sh.github.io/animesama-cli/apt stable main" | sudo tee /etc/apt/sources.list.d/animesama.list
sudo apt update && sudo apt install animesama-cli

Fedora / RHEL

Add the repository file, then install:

sudo curl -fsSL -o /etc/yum.repos.d/animesama.repo https://miro-sh.github.io/animesama-cli/rpm/animesama.repo
sudo dnf install animesama-cli

dnf will ask you to trust the GPG key (fingerprint 035B2D3F0897E499) on first install.

Arch Linux

yay -S animesama-cli

macOS

brew install Miro-sh/tap/animesama

pipx (any distribution)

pipx install animesama

Windows

Run the following command in PowerShell (no administrator rights required):

irm "https://raw.githubusercontent.com/Miro-sh/animesama-cli/refs/heads/master/install_windows.bat" -OutFile install.bat; .\install.bat

The script installs the application via pipx and downloads mpv. Restart your terminal after installation, then run animesama-cli.

Usage

Command	Description
animesama-cli	Launch the TUI (falls back to CLI if Textual is not installed)
animesama-cli --cli	Force CLI mode
animesama-cli naruto	Search directly
animesama-cli --vf naruto	Search French dub only
animesama-cli -c	Show watch history
animesama-cli -cf	History with last-episode check
animesama-cli -p	Weekly schedule
animesama-cli -up	Upcoming episodes
animesama-cli --debug naruto	Search with debug output
animesama-cli -h	Show all options

The watch history is stored at ~/.local/share/animesama-cli/history.db and can be opened with any SQLite browser.

Uninstall

apt / dnf:

sudo apt remove animesama-cli    # Debian/Ubuntu
sudo dnf remove animesama-cli    # Fedora

AUR:

yay -R animesama-cli

Homebrew:

brew uninstall animesama

pipx (Linux and Windows):

pipx uninstall animesama

Windows (mpv installed by the script):

rd /s /q "%USERPROFILE%\AnimeSamaCLI"

Old manual installs (before 1.0.7):

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

Dependencies

Category	Packages
Python	requests, beautifulsoup4, textual (optional, for the TUI), windows-curses (Windows only)
System	mpv, git, python3

Built-in Python modules used: sqlite3, re, json, sys, os, time, datetime, locale, pathlib, subprocess, asyncio.

FAQ

Click to expand

Can I change or disable subtitles? No. Subtitles are embedded in the video stream.

Can I watch in French? Yes. Use --vf when searching.

Can I switch the audio language? No. The site only provides French dub and Japanese audio with French subtitles.

Can I use a different video source? No, unless you write your own scraper.

Can I use VLC? No. Only mpv is supported.

Where can I find all the options? Run animesama-cli --help.

Related projects

• ani-cli: Japanese audio, English subtitles (4anime, gogoanime, allmanga). animesama-cli was inspired by this project.
• GoAnime: Japanese audio, Portuguese subtitles
• doccli: Japanese audio, Polish subtitles (docchi.pl)

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening an issue or pull request. You can also join the Discord server to discuss the project.

Disclaimer

This project only fetches publicly available content and hosts nothing itself. Users are responsible for how they use it. See DISCLAIMER.md for details.