ani-cli

Search anime by name

$ ani-cli "[anime_name]"

$ ani-cli [[-d|--download]] "[anime_name]"

$ ani-cli [[-d|--download]] [[-r|--range]] "[1 6]" "[anime_name]"

$ ani-cli [[-d|--download]] [[-r|--range]] "1 -1" "[anime_name]"

$ ani-cli [[-v|-vlc]] "[anime_name]"

$ ani-cli [[-e|--episode]] [episode_number] "[anime_name]"

$ ani-cli [[-c|--continue]]

$ ani-cli [[-U|--update]]

ani-cli [options] [episode_number]

-h, --help
    Show help message and exit.

-v, --version
    Show program's version number and exit.

-s , --source
    Specify the streaming source to use (e.g., gogoanime, crunchyroll, etc.). If not specified, ani-cli prompts the user to select a source from a list.

-e , --episode
    Specify the episode number to watch. If not specified, ani-cli prompts the user to select the episode.

-p , --player
    Specify the video player to use (e.g., mpv, vlc). If not specified, ani-cli uses the default player configured in its settings.

-q , --quality
    Specify the video quality to use (e.g., 720p, 1080p). If not specified, ani-cli uses the default quality configured in its settings.

-a, --auto
    Automatically select the first available source and episode.


    The name of the anime to search for.

[episode_number]
    Optional episode number to watch.

ani-cli is a command-line tool for watching anime without using a web browser. It's designed for Linux-based systems and provides a way to search, select, and stream anime from various sources directly through your terminal.

The tool automates much of the interaction one would typically have with a browser-based anime streaming website. Users can search by name, browse available episodes, choose their preferred streaming source from a list, and watch the selected episode in their preferred video player (e.g., mpv, VLC). It handles the complexities of navigating web pages and extracting video links, providing a streamlined anime viewing experience. ani-cli aims to be lightweight and efficient, leveraging the power of the command line for a quick and distraction-free way to watch anime. Users often configure their video players with options such as hardware acceleration for optimal performance.

ani-cli relies on external websites and services for streaming anime. Therefore, its functionality can be affected by changes to these sites. Legal and ethical considerations should be taken into account when using this tool.

ani-cli can be configured through a configuration file, typically located at ~/.config/ani-cli/config.json. This file allows users to set default streaming sources, video players, quality preferences, and other settings.

The config file uses json format.

ani-cli requires dependencies such as Python 3, requests (a Python library), and a video player like mpv or VLC. Ensure these dependencies are installed on your system before using ani-cli.

ani-cli emerged as a project aimed at providing a terminal-based solution for anime viewing. It gained popularity among command-line enthusiasts and users seeking a more minimalist anime experience. The tool is continuously developed with new sources, features, and bug fixes contributed by an open-source community.

mpv(1), vlc(1), curl(1)