animesama 1.0.17

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

animesama-cli

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

Demo

Overview

animesama-cli is a terminal application for browsing and watching anime from anime-sama.fr. 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.fr 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.fr
• 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

Linux

Debian / Ubuntu (apt repository):

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 (dnf repository):

sudo dnf config-manager --add-repo https://miro-sh.github.io/animesama-cli/rpm/animesama.repo
sudo dnf install animesama-cli

Arch Linux (AUR):

yay -S animesama-cli

Any distribution with pipx (requires mpv):

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

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.