ani-cli-demo.webm
Table of Contents
Fixing errors
If you encounter Blocked by cloudflare. Try installing curl-impersonate then install curl-impersonate from your respective package manager.
If it is not available, then download from their github by running the following commands.
curl -LO "https://github.com/lwthiker/curl-impersonate/releases/download/v0.6.1/curl-impersonate-v0.6.1.x86_64-linux-gnu.tar.gz"
sudo tar xf curl-impersonate-v0.6.1.x86_64-linux-gnu.tar.gz -C /usr/local/bin
For other network errors, check the current status by clicking on these badges:
For any other breaking issue, then make sure you are on latest version by typing sudo ani-cli -U to update on Linux, Mac and Android. On Windows, run ani-cli -U.
If after this the issue persists then open an issue.
Install
Tier 1 Support: Linux, Mac, Android
These Platforms have rock solid support and are used by maintainers and large parts of the userbase.
Native Packages
Native packages have a more robust update cycle, but sometimes they are slow to upgrade.
If the one for your platform is up-to-date we suggest going with it.
sudo apt install ani-cli
To install mpv (and vlc) you need RPM Fusion free enabled. Simply follow the instructions here: https://rpmfusion.org/Configuration
To be able to install syncplay, you'll need to enable this copr repo (instructions included): https://copr.fedorainfracloud.org/coprs/batmanfeynman/syncplay/.
To install ani-cli:
sudo dnf copr enable derisis13/ani-cli
sudo dnf install ani-cli
If for your distro uses rpm and you would like to see a native package, open an issue.
Build and install from the AUR:
yay -S ani-cli
Also consider ani-cli-git
Build and install from the GURU:
sudo eselect repository enable guru
sudo emaint sync -r guru
sudo emerge -a ani-cli
Consider using the 9999 ebuild.
sudo emerge -a =app-misc/ani-cli-9999
On Suse the provided MPV and VLC packages are missing features that are used by ani-cli. The only required is the "Only Essentials" repository which has versions for each Suse release.
You can find instructions on this here.
To add the ani-cli copr repo, update then install ani-cli run (on both versions):
zypper addrepo https://download.copr.fedorainfracloud.org/results/derisis13/ani-cli/opensuse-tumbleweed-x86_64/ ani-cli
zypper dup
zypper install ani-cli
You'll get a warning about Signature verification failed [4-Signatures public key is not available] but this can be ignored from the prompt.
Note: package is noarch, so any architecture should work, even though the repo is labelled x86-64
Install HomeBrew if not installed.
brew tap pystardust/ani-cli https://github.com/pystardust/ani-cli.git
brew trust pystardust/ani-cli
brew install ani-cli && brew install --cask iina
Why iina and not mpv? Drop-in replacement for mpv for MacOS. Integrates well with OSX UI. Excellent support for M1. Open Source.
Alternatively, a MacPorts package is available.
Install it with sudo port install ani-cli.
Install termux (Guide)
Termux package
pkg up -y
pkg install ani-cli
If you're using Android 14 make sure to run this due to #1206:
pkg install termux-am
For players you can use the apk (playstore/fdroid) versions of mpv and vlc. Note that these cannot be checked from termux so a warning is generated when checking dependencies.
Important Note: The streams only play with the right referrer, which mpv on Android has to read from a config file:
- Run this command and allow storage permissions:
termux-setup-storage
- Go to MPV > Settings > Advanced > mpv.conf
- add this line:
include="/storage/emulated/0/mpv/mpv.config.mp4"
- Make sure to have storage (photos and videos on newer android) permission allowed to both MPV and termux. These permissions are asked by mpv if you click on the "file picker (legacy)" option.
VLC on Android cannot be given the referrer, so it does not play the current provider.
Tier 2 Support: Windows, WSL, iOS, Steam Deck, FreeBSD, Ubuntu Touch
While officially supported, installation is more involved on these platforms and sometimes issues arise.
Reach out if you need help.
ani-cli is on scoop. Please read further for setup instructions.
We will set up the bash.exe that comes with Git for Windows to be used with Windows Terminal. You may use terminals such as Wezterm or Alacritty, but this guide only covers Windows Terminal. The Git Bash terminal (i.e., mintty) has problems with fzf.
First, you'll need to install the scoop package manager. (Install) Follow quickstart.
Next, get Windows Terminal. It comes preinstalled on Windows 11. If you do not have it, install it by running the following commands in powershell.
scoop bucket add extras
scoop install extras/windows-terminal
This is the beginning of the README. Read the rest at the original. Read the full README ↗
