{"id":17690062,"url":"https://github.com/71zenith/ani-cli","last_synced_at":"2025-03-30T22:14:11.269Z","repository":{"id":179874836,"uuid":"664261662","full_name":"71zenith/ani-cli","owner":"71zenith","description":null,"archived":false,"fork":false,"pushed_at":"2023-07-09T12:37:03.000Z","size":11517,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-06T02:45:12.598Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/71zenith.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-09T12:27:45.000Z","updated_at":"2023-07-09T12:29:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"5f2fd464-b936-4ff3-a7bc-a4b79121f8f8","html_url":"https://github.com/71zenith/ani-cli","commit_stats":null,"previous_names":["71zenith/ani-cli"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/71zenith%2Fani-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/71zenith%2Fani-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/71zenith%2Fani-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/71zenith%2Fani-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/71zenith","download_url":"https://codeload.github.com/71zenith/ani-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246385415,"owners_count":20768672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-24T11:49:42.400Z","updated_at":"2025-03-30T22:14:11.230Z","avatar_url":"https://github.com/71zenith.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=center\u003e\n\u003cbr\u003e\n\u003ca href=\"http://makeapullrequest.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/PRs-welcome-brightgreen.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"#Linux\"\u003e\u003cimg src=\"https://img.shields.io/badge/os-linux-brightgreen\"\u003e\n\u003ca href=\"#MacOS\"\u003e\u003cimg src=\"https://img.shields.io/badge/os-mac-brightgreen\"\u003e\n\u003ca href=\"#Windows\"\u003e\u003cimg src=\"https://img.shields.io/badge/os-windows-brightgreen\"\u003e\n\u003ca href=\"#Android\"\u003e\u003cimg src=\"https://img.shields.io/badge/os-android-brightgreen\"\u003e\n\u003ca href=\"#iOS\"\u003e\u003cimg src=\"https://img.shields.io/badge/os-ios-brightgreen\"\u003e\n\u003ca href=\"#Steam-deck\"\u003e\u003cimg src=\"https://img.shields.io/badge/os-steamdeck-brightgreen\"\u003e\n\u003cbr\u003e\n\u003ch1 align=\"center\"\u003e\n\u003ca href=\"https://discord.gg/aqu7GpqVmR\"\u003e\n\u003cimg src=\"https://invidget.switchblade.xyz/aqu7GpqVmR\"\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\u003ca href=\"https://github.com/port19x\"\u003e\u003cimg src=\"https://img.shields.io/badge/lead-port19x-lightblue\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/CoolnsX\"\u003e\u003cimg src=\"https://img.shields.io/badge/maintainer-CoolnsX-blue\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/justchokingaround\"\u003e\u003cimg src=\"https://img.shields.io/badge/maintainer-justchokingaround-blue\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/Derisis13\"\u003e\u003cimg src=\"https://img.shields.io/badge/maintainer-Derisis13-blue\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/71zenith\"\u003e\u003cimg src=\"https://img.shields.io/badge/maintainer-71zenith-blue\"\u003e\u003c/a\u003e\n\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003e\nA cli to browse and watch anime (alone AND with friends). This tool scrapes the site \u003ca href=\"https://allanime.to/\"\u003eallanime.\u003c/a\u003e\n\u003c/h3\u003e\n\t\n\u003ch1 align=\"center\"\u003e\n\tShowcase\n\u003c/h1\u003e\n\n[ani-cli-demo.webm](https://user-images.githubusercontent.com/44473782/224679247-0856e652-f187-4865-bbcf-5a8e5cf830da.webm)\n\n## Table of Contents\n\n- [Fixing errors](#Fixing-errors)\n- [Install](#Install)\n  - [Linux](#Linux)\n   - [Debian](#Debian-unstable)\n   - [Fedora](#Fedora)\n   - [Arch](#Arch)\n   - [OpenSuse Tumbleweed and Leap](#OpenSuse-Tumbleweed-and-Leap)\n   - [From source](#Installing-from-source)\n  - [MacOS](#MacOS)\n  - [Windows](#Windows)\n  - [Android](#Android)\n  - [Steam Deck](#Steam-deck)\n  - [iOS](#iOS)\n- [Uninstall](#Uninstall)\n- [Dependencies](#Dependencies)\n- [Homies](#Homies)\n- [Contribution Guidelines](./CONTRIBUTING.md)\n- [Disclaimer](./disclaimer.md)\n\n## Fixing errors\n\nIf you encounter \"Video url not found\" or any breaking issue, then make sure you are on latest version by typing\n`sudo ani-cli -U` to update on Linux, Mac and Android. On Windows, run gitbash as administrator then there type `ani-cli -U`.\nIf after this the issue persists then open an issue.\n\nHistory has been reworked and relocated. We're working on a transition script, please be patient. Old history can be viewed with `less ${XDG_CACHE_HOME:-$HOME/.cache}/ani-hsts`\n\n## Install\n\n#### Users of V3.2 or the v3.2.x series should uninstall before upgrading\nOtherwise you're likely to see an error like the following: ` \"/usr/bin/ani-cli: line 470: (...)/player_mpv: No such file or directory\"`\n\n### Native packages\n\n[![Packaging status](https://repology.org/badge/vertical-allrepos/ani-cli.svg?minversion=4.0)](https://repology.org/project/ani-cli/versions)\n\n*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.*\n\n### Linux\n\n#### Debian unstable\n\n```sh\nsudo apt install ani-cli\n```\n\n#### Fedora\n\nTo install mpv (and vlc) you need _RPM Fusion free_ enabled. Simply follow the instructions here: https://rpmfusion.org/Configuration\nTo be able to install syncplay, you'll need to enable this copr repo (instructions included): https://copr.fedorainfracloud.org/coprs/batmanfeynman/syncplay/.\n\nTo install ani-cli:\n```sh\nsudo dnf copr enable derisis13/ani-cli\nsudo dnf install ani-cli\n```\n*If for your distro uses rpm and you would like to see a native package, open an issue.*\n\n#### Arch\n\nBuild and install from the AUR:\n```sh\nyay -S ani-cli\n```\nAlso consider `ani-cli-git`\n\n#### Gentoo\n\nBuild and install from the GURU:\n```sh\nsudo eselect repository enable guru\nsudo emaint sync -r guru\nsudo emerge -a ani-cli\n```\nConsider using the 9999 ebuild.\n```sh\nsudo emerge -a =app-misc/ani-cli-9999\n```\n\n#### OpenSuse Tumbleweed and Leap\n\nOn 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.\nYou can find instructions on this [here](https://en.opensuse.org/Additional_package_repositories#Packman).\n\nTo add the ani-cli copr repo, update then install ani-cli run (on both versions):\n```sh\nzypper addrepo https://download.copr.fedorainfracloud.org/results/derisis13/ani-cli/opensuse-tumbleweed-x86_64/ ani-cli\nzypper dup\nzypper install ani-cli\n```\nYou'll get a warning about `Signature verification failed [4-Signatures public key is not available]` but this can be ignored from the prompt.\n\n*Note: package is noarch, so any architecture should work, even though the repo is labelled x86-64*\n\n#### Installing from source\n\nInstall dependencies [(See below)](#Dependencies)\n\n```sh\nsudo rm -rf \"/usr/local/share/ani-cli\" \"/usr/local/bin/ani-cli\" \"/usr/local/bin/UI\" /usr/local/bin/player_* #If some of these aren't found, it's not a problem\ngit clone \"https://github.com/pystardust/ani-cli.git\"\nsudo cp ani-cli/ani-cli /usr/local/bin\nrm -rf ani-cli\n```\n\n### MacOS\n\nInstall dependencies [(See below)](#Dependencies)\n\nInstall [HomeBrew](https://docs.brew.sh/Installation) if not installed.\n\n```sh\nrm -rf \"$(brew --prefix)/share/ani-cli\" \"$(brew --prefix)/bin/ani-cli\" \"$(brew --prefix)/bin/UI\" \"$(brew --prefix)\"/bin/player_* #If some of these aren't found, it's not a problem\ngit clone \"https://github.com/pystardust/ani-cli.git\" \u0026\u0026 cd ./ani-cli\ncp ./ani-cli \"$(brew --prefix)\"/bin\ncd .. \u0026\u0026 rm -rf ./ani-cli\n```\n\n*To install (with Homebrew) the dependencies required on Mac OS, you can run:*\n\n```sh\nbrew install curl grep aria2 ffmpeg git fzf yt-dlp \u0026\u0026 \\\nbrew install --cask iina\n```\n*Why iina and not mpv? Drop-in replacement for mpv for MacOS. Integrates well with OSX UI. Excellent support for M1. Open Source.*\n\n### Windows\n\n*ani-cli needs a posix shell and the current way is git bash. Unfortunately fzf can't run in git bash's default terminal. The solution is to use git bash in windows terminal*\n\nFirst, you'll need windows terminal preview. [(Install)](https://apps.microsoft.com/store/detail/windows-terminal-preview/9N8G5RFZ9XK3?hl=de-at\u0026gl=at\u0026rtc=1)\n\nThen make sure git bash is installed. [(Install)](https://git-scm.com/download/win) It needs to be added to windows terminal [(Instructions)](https://stackoverflow.com/questions/56839307/adding-git-bash-to-the-new-windows-terminal)\n\nThe following steps and ani-cli need to be run from git bash in windows terminal.\n\n#### Scoop bucket\n\n```sh\nscoop bucket add extras\nscoop install ani-cli\n```\n\n#### From source\n```sh\nrm -rf \"/usr/local/share/ani-cli\" \"/usr/local/bin/ani-cli\" \"/usr/local/bin/UI\" /usr/local/bin/player_* #If some of these aren't found, it's not a problem\ngit clone \"https://github.com/pystardust/ani-cli.git\"\ncp ani-cli/ani-cli /usr/bin\nrm -rf ani-cli\n```\n\n#### Dependencies\n\nAll dependencies can be installed with scoop (from the extras bucket), however some users experienced that installed programs aren't always added to the path. If this happens installing from winget instead usually works.\n\nNote that curl can cause issues.\nani-cli has been tested unsuccessfully with curl `7.83.1` and successfully with `7.86.0`.\nIf you run into issues, try the scoop install or grab the newest curl you can find.\n\n### Android\n\nInstall termux [(Guide)](https://termux.com/)\n\n#### Termux package\n\n```sh\npkg up -y\npkg install ani-cli\n```\n\n#### From source\n\n```sh\npkg up -y\nrm -rf \"$PREFIX/share/ani-cli\" \"$PREFIX/bin/ani-cli\" \"$PREFIX/bin/UI\" \"$PREFIX\"/local/bin/player_* #If some of these aren't found, it's not a problem\ngit clone \"https://github.com/pystardust/ani-cli.git\"\ncp ani-cli/ani-cli \"$PREFIX\"/bin\nrm -rf ani-cli\n```\n\nFor 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.\n\n### iOS\nInstall iSH and VLC from the app store.\n\nMake sure apk is updated using\n```apk update; apk upgrade```\nthen run this:\n```sh\napk add grep sed curl fzf git aria2 alpine-sdk ncurses\ngit clone https://github.com/Lockl00p/ffmpeglibs-iSH.git ~/ffmpeg\ncd ~/ffmpeg\ncat fmp.?? \u003e ffmpeg.tar.gz\ntar -xvf ffmpeg.tar.gz\ncd FFmpeg\nmake install\ncd\nrm -rf ffmpeg\napk add ffmpeg\ngit clone https://github.com/pystardust/ani-cli ~/.ani-cli\ncp ~/.ani-cli/ani-cli /usr/local/bin/ani-cli\nchmod +x /usr/local/bin/ani-cli\nrm -rf ~/.ani-cli\n```\nnote that downloading is going to be very slow. This is an iSH issue, not an ani-cli issue.\n\n### Steam Deck\n\n#### Copypaste script:\n\n* Switch to Desktop mode (`STEAM` Button \u003e Power \u003e Switch to Desktop)\n* Open `Konsole` (Steam Deck Icon in bottom left corner \u003e System \u003e Konsole)\n* Copy the script, paste it in the CLI and press Enter(\"A\" button on Steam Deck)\n\n```sh\n[ ! -d ~/.local/bin ] \u0026\u0026 mkdir ~/.local/bin \u0026\u0026 echo \"export $PATH=$HOME/.local/bin:$PATH\" \u003e\u003e \".$(echo $SHELL | sed -nE \"s|.*/(.*)\\$|\\1|p\")rc\"\n\ngit clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf\n~/.fzf/install\n\nmkdir ~/.aria2c\ncurl -o ~/.aria2c/aria2-1.36.0.tar.bz2 https://github.com/q3aql/aria2-static-builds/releases/download/v1.36.0/aria2-1.36.0-linux-gnu-64bit-build1.tar.bz2\ntar xvf ~/.aria2c/aria2-1.36.0.tar.bz2 -C ~/.aria2c/\ncp ~/.aria2c/aria2-1.36.0-linux-gnu-64bit-build1/aria2c ~/.local/bin/\nchmod +x ~/.local/bin/aria2c\n\ncurl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/.local/bin/yt-dlp\nchmod +x ~/.local/bin/yt-dlp\n\ngit clone https://github.com/pystardust/ani-cli.git ~/.ani-cli\ncp ~/.ani-cli/ani-cli ~/.local/bin/\n\nflatpak install io.mpv.Mpv\n```\npress enter(\"A\" button on Steam Deck) on questions\n\n#### Installation in steps:\n\n##### Install mpv (Flatpak version):\n\n```sh\nflatpak install io.mpv.Mpv\n```\npress enter(\"A\" button on Steam Deck) on questions\n\n##### Install [fzf](https://github.com/junegunn/fzf):\n\n```sh\ngit clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf\n~/.fzf/install\n```\npress enter(\"A\" button on Steam Deck) on questions\n\n##### Make a ~/.local/bin folder if doesn't exist and add it to $PATH\n\n```sh\n[ ! -d ~/.local/bin ] \u0026\u0026 mkdir ~/.local/bin \u0026\u0026 echo \"export $PATH=$HOME/.local/bin:$PATH\" \u003e\u003e \".$(echo $SHELL | sed -nE \"s|.*/(.*)\\$|\\1|p\")rc\"\n```\n\n##### Install [aria2](https://github.com/aria2/aria2) (needed for download feature only):\n\n```sh\nmkdir ~/.aria2c\ncurl -o ~/.aria2c/aria2-1.36.0.tar.bz2 https://github.com/q3aql/aria2-static-builds/releases/download/v1.36.0/aria2-1.36.0-linux-gnu-64bit-build1.tar.bz2\ntar xvf ~/.aria2c/aria2-1.36.0.tar.bz2 -C ~/.aria2c/\ncp ~/.aria2c/aria2-1.36.0-linux-gnu-64bit-build1/aria2c ~/.local/bin/\nchmod +x ~/.local/bin/aria2c\n```\n\n##### Install [yt-dlp](https://github.com/yt-dlp/yt-dlp) (needed for download feature only):\n\n```sh\ncurl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/.local/bin/yt-dlp\nchmod +x ~/.local/bin/yt-dlp\n```\n\n##### Install ani-cli:\n\n```sh\ngit clone https://github.com/pystardust/ani-cli.git ~/.ani-cli\ncp ~/.ani-cli/ani-cli ~/.local/bin/\n```\n\n##### Optional: add desktop entry:\n\n```\necho '[Desktop Entry]\nEncoding=UTF-8\nVersion=4.0\nType=Application\nExec=konsole -e ani-cli\nName=ani-cli' \u003e ~/.local/share/applications/ani-cli.desktop\n```\nThe .desktop entry will allow to start ani-cli in Konsole directly from \"Gaming Mode\"\nIn Steam Desktop app:\n`Add game` \u003e `Add a non-steam game` \u003e tick a box for `ani-cli` \u003e `Add selected programs`\n*Note: Konsole window size bugs out if launched from \"Gaming Mode\".*\n*Note: this is not working the way it should yet.*\n\n## Uninstall\n\n* apt:\n```sh\nsudo apt remove ani-cli\n# to remove the repository from apt\nsudo rm -f /etc/apt/trusted.gpg.d/ani-cli.asc /etc/apt/sources.list.d/ani-cli-debian.list\n```\n* dnf:\n```sh\nsudo dnf remove ani-cli      # for ani-cli\n# disable the repo in dnf\ndnf copr disable derisis13/ani-cli\n```\nYou might want to uninstall RPM fusion if you don't use it otherwise\n* zypper:\n```sh\nzypper remove ani-cli\nzypper removerepo ani-cli\n```\nYou might want to remove `packman-essentials` if you don't need it otherwise\n* AUR:\n```sh\nyay -R ani-cli\n```\n* Scoop:\n```sh\nscoop uninstall ani-cli\n```\n* Linux:\n```sh\nsudo rm \"/usr/local/bin/ani-cli\"\n```\n* Mac:\n```sh\nrm \"$(brew --prefix)/bin/ani-cli\"\n```\n* Windows:\nIn **Git Bash** run (as administrator):\n```sh\nrm \"/usr/bin/ani-cli\"\n```\n* Termux package\n```sh\npkg remove ani-cli\n```\n* Android:\n```sh\nrm \"$PREFIX/bin/ani-cli\"\n```\n* Steam Deck\n```sh\nrm \"~/.local/bin/ani-cli\"\nrm -rf ~/.ani-cli\n```\noptionally: remove dependencies:\n```sh\nrm ~/.local/bin/aria2c\nrm ~/.local/bin/yt-dlp\nrm -rf \"~/.aria2\"\nrm -rf \"~/.fzf\"\nflatpak uninstall io.mpv.Mpv\n```\n* iOS\n```\nrm -rf /usr/local/bin/ani-cli\n```\nTo uninstall FFmpeg:\n```\nrm -rf /usr/local/lib/libavutil.a /usr/local/lib/libavcodec.a /usr/local/lib/libavformat.a /usr/local/lib/pkgconfig/libavutil.a /usr/local/lib/pkgconfig/libavcodec.a /usr/local/lib/pkgconfig/libavformat.a\napk del ffmpeg\n```\nTo uninstall other dependencies:\n```\napk del grep sed curl fzf git aria2 alpine-sdk ncurses\n```\n## Dependencies\n\n- grep\n- sed\n- curl\n- mpv - Video Player\n- iina - mpv replacement for MacOS\n- aria2c - Download manager\n- yt-dlp - m3u8 Downloader\n- ffmpeg - m3u8 Downloader (fallback)\n- fzf - User interface\n\n## Homies\n\n* [animdl](https://github.com/justfoolingaround/animdl): Ridiculously efficient, fast and light-weight (supports most sources: allanime, zoro ... (Python)\n* [jerry](https://github.com/justchokingaround/jerry): stream anime with anilist tracking and syncing, with discord presence (Shell)\n* [anipy-cli](https://github.com/sdaqo/anipy-cli): ani-cli rewritten in python (Python)\n* [saikou](https://github.com/saikou-app/saikou): Best android app for anime/manga with anilist integration (Kotlin)\n* [mangal](https://github.com/metafates/mangal): Download \u0026 read manga from any source with anilist sync (Go)\n* [lobster](https://github.com/justchokingaround/lobster): Watch movies and series from the terminal (Shell)\n* [mov-cli](https://github.com/mov-cli/mov-cli): Watch movies/shows in the cli (Python/Shell)\n* [dra-cla](https://github.com/CoolnsX/dra-cla): ani-cli equivalent for korean dramas (Shell)\n* [redqu](https://github.com/port19x/redqu):  A media centric reddit client (Clojure)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F71zenith%2Fani-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F71zenith%2Fani-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F71zenith%2Fani-cli/lists"}