ANI-CLI(1) User Commands ANI-CLI(1)

ani-cli - watch anime from the commandline

ani-cli [OPTIONS]

A shell script to browse and search anime from the command-line.

This tool scrapes the site allanime.

ani-cli without options defaults to iina on macOS, flatpak mpv on Steamdeck, mpv apk on android, vlc on iOS and mpv media player everywhere else.

Specify the episode numbers to watch. If range is specified it should be quoted or separated by a non-numeric character (eg. -).
Continue watching anime from history.
Download episode.
Delete history.
Selects nth entry.
Show summary of options.
Set the video quality. Default quality is best.
Watch anime together with friends, using Syncplay (works with mpv only).
Fetch update from github.
Use VLC as the media player.
Disable the interactive menu.
Selects nth entry.
Play the dubbed version. Without this flag, it'll always play the subbed version.
Use rofi instead of fzf for the interactive menu
Use ani-skip to skip the intro of the episode (mpv only)
Don't detach the player (useful for in-terminal playback, mpv only)
Specify the title to use for ani-skip

ani-cli v4 uses environment variables to control unstable/untested and niche features in addition to everything that has an option. Command-line options take precedence over env vars. Note that these are all subject to change.

Controls the scraped media's mode, valid options are sub or dub. Default is sub.
Controls the directory where files are downloaded. Default is the current dir.
Controls the scraped media's quality, check allanime for valid options or set to worst/best. Default is best.
Sets the player ani-cli uses. Can be debug (print links), download (equivalent to -d), android_mpv (apk and am start), android_vlc (apk and am start), flatpak_mpv (for flatpak), catt (for streaming to tv), or any player that can play urls. For defaults see working without arguments.
Controls the frontend of ani-cli. Can be 0 (uses fzf) or 1 (uses rofi dmenu). Default is 0.
Controls the multi flag for the chosen frontend. Default is -m for fzf and --multi-select for rofi dmenu.
Enabled by default if both -e and -S are given. Disables fzf dependency check. Also disables some debug information if running with ANI_CLI_PLAYER="debug"
Controls the directory ani-cli uses for storing history. A /ani-cli subfolder is created there for the histfile if doesn't exists. Default is $XDG_STATE_HOME if set, $HOME/.local/state if not.
Controls the default source. Valid is history (equivalent to -c), everything else means search. Default is search.
Controls if ani-skip is used to skip intros (works with mpv only). Can be 0 (disabled) or 1 (enabled). Default is 0.
Controls if mpv is detached from the main process for playback, which can be useful for use with terminal renderers such as kitty. (works with mpv only). Can be 0 (disabled) or 1 (enabled). Default is 0.
Overrides the anime title to query for skip times. Can be any string value. Default is empty, resolving to the anime title as given by ani-cli.

Multiple episodes can be chosen using fzf (or alternative frontend's) multi-selection mode. For this refer to their instructions.

Use the GitHub issue tracker: https://github.com/pystardust/ani-cli/issues

ani-cli is licensed under the GNU General Public License v3.0

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

January 2023 ani-cli