LinuxCommandLibrary

ani-cli

Stream anime episodes from the command line

TLDR

Search anime by name

$ ani-cli "[anime_name]"
copy

Download an episode
$ ani-cli [[-d|--download]] "[anime_name]"
copy

Download a range of episodes
$ ani-cli [[-d|--download]] [[-r|--range]] "[1 6]" "[anime_name]"
copy

Download the entire series (a range of all episodes)
$ ani-cli [[-d|--download]] [[-r|--range]] "1 -1" "[anime_name]"
copy

Use VLC as the media player
$ ani-cli [[-v|-vlc]] "[anime_name]"
copy

Watch a specific episode
$ ani-cli [[-e|--episode]] [episode_number] "[anime_name]"
copy

Continue watching anime from history
$ ani-cli [[-c|--continue]]
copy

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

SYNOPSIS

ani-cli [options] [episode_number]

PARAMETERS

-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.

DESCRIPTION

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.

CAVEATS

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.

CONFIGURATION

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.

DEPENDENCIES

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.

HISTORY

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.

SEE ALSO

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

Copied to clipboard