README

Discord
Matrix











A cli to browse and watch anime (alone AND with friends). This tool scrapes the site hianime.



	Showcase


ani-cli-demo.webm

 Table of Contents

- Fixing errors
- Install
  - Tier 1: Linux, Mac, Android
  - Tier 2: Windows, WSL, iOS, Steam Deck, FreeBSD, Ubuntu Touch
  - From Source
- Uninstall
- Dependencies
  - Ani-Skip
- FAQ
- Homies
- Contribution Guidelines
- Disclaimer

 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.

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

Linux

 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.

Debian 13/unstable

sh
sudo apt install ani-cli



Fedora

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

Arch

Build and install from the AUR:
sh
yay -S ani-cli

Also consider ani-cli-git

Gentoo

Build and install from the GURU:
sh
sudo eselect repository enable guru
sudo emaint sync -r guru
sudo emerge -a ani-cli

Consider using the 9999 ebuild.
sh
sudo emerge -a =app-misc/ani-cli-9999


OpenSuse

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):
sh
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, e

Top issues

Discussions

Latest release

In this release, iOS is broken, we hope to restore it in the future.
You may also want to back up your history due to yet another provider change.
Let's hope this one lasts a little longer.

 What's Changed
 chore: bump homebrew formula by @port19x in https://github.com/pystardust/ani-cli/pull/1846
 docs: add instructions for curl-impersonate by @71zenith in https://github.com/pystardust/ani-cli/pull/1847
 docs: Enhance doccli entry in README by @TowarzyszFatCat in https://github.com/pystardust/ani-cli/pull/1855
 ci: fix ci paths by @port19x in https://github.com/pystardust/ani-cli/pul