原生软件包

原生软件包有更稳健的更新周期，但有时升级较慢。如果你的平台的软件包是最新的，我们建议使用它。

要安装 mpv（和 vlc），您需要启用 RPM Fusion free。只需按照此处的说明操作：https://rpmfusion.org/Configuration 要安装 syncplay，您需要启用此 copr 仓库（包含说明）：https://copr.fedorainfracloud.org/coprs/batmanfeynman/syncplay/。

要安装 ani-cli：

sudo dnf copr enable derisis13/ani-cli
sudo dnf 安装 ani-cli

如果您的发行版使用 rpm 并且您希望看到原生包，请提出一个问题。

从 AUR 构建并安装：

yay -S ani-cli

也可以考虑 ani-cli-git

从 GURU 构建和安装：

sudo eselect repository enable guru
sudo emaint sync -r guru
sudo emerge -a ani-cli

考虑使用 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.

要添加 ani-cli copr 仓库，请更新然后安装 ani-cli（在两个版本上运行）：

zypper addrepo https://download.copr.fedorainfracloud.org/results/derisis13/ani-cli/opensuse-tumbleweed-x86_64/ ani-cli
zypper dup zypper 安装 ani-cli

您会收到关于Signature verification failed [4-Signatures public key is not available]的警告，但可以忽略提示。

注意：软件包是 noarch，任何架构都可以使用，即使仓库标记为 x86-64

如果未安装，请安装 HomeBrew。

酿造水龙头 pystardust/ani-cli  https://github.com/pystardust/ani-cli.git
酿造信任 pystardust/ani-cli 酿造安装 ani-cli  &  &  酿造安装 --cask iina

为什么选择 iina 而不是 mpv？MacOS 的 mpv 替代品。与 OSX UI 集成良好，对 M1 支持优秀。开源软件。

安装 termux （指南）

Termux 软件包

pkg up -y
pkg 安装 ani-cli

如果你使用的是 Android 14，请务必运行此命令，原因见 #1206：

pkg 安装 termux-am

对于播放器，你可以使用 mpv 和 vlc 的 apk（Play 商店/F-Droid）版本。注意，这些版本无法从 termux 检查，因此检查依赖项时会生成警告。

重要提示： 这些流媒体只有在正确的引用来源下才能播放，而 Android 上的 mpv 必须从配置文件中读取该引用来源：

• 运行此命令并允许存储权限：

  termux-setup-storage

• 进入 MPV > 设置 > 高级 > mpv.conf
• 添加这一行：

  包含="/storage/emulated/0/mpv/mpv.config.mp4"

• 确保对 MPV 和 Termux 都允许存储（在新 Android 上的照片和视频）权限。如果你点击 " 文件选择器（旧版）" 选项，MPV 会请求这些权限。

VLC 在安卓上无法被赋予引用来源，因此无法播放当前提供商的内容。

ani-cli 在 scoop 上。请继续阅读了解安装说明。

我们将设置随 Git for Windows 提供的 bash.exe，以便在 Windows Terminal 中使用。您可以使用 Wezterm 或 Alacritty 等终端，但本指南仅涵盖 Windows Terminal。Git Bash 终端（即 mintty）与 fzf 存在问题。

首先，您需要安装 scoop 包管理器。(安装) 请遵循 快速开始 指南。

接下来，获取 Windows Terminal。Windows 11 已预装该程序。如果您没有，请在 powershell 中运行以下命令进行安装。

勺子 桶 添加额外材料
scoop 安装 extras/windows-terminal

接下来，获取 git。如果您已经安装，请更新它。如果尚未安装，请在 powershell 中运行 scoop install git 进行安装。

确保 Git Bash 出现在 Windows Terminal 的标签下拉菜单中，如下所示。

如果没有，请添加它。要添加它，首先点击新标签按钮旁边的下拉按钮（如上所示）。

然后，导航到 设置 > 配置文件 > 添加新配置文件。点击 新建空白配置文件。

接下来：

• 如果你使用 scoop 安装了 git：将 名称 设置为 " Git Bash "，将 命令行 设置为 %GIT_INSTALL_ROOT%\bin\bash.exe -i -l，并将 图标 设置为 %GIT_INSTALL_ROOT%\mingw64\share\git\git-for-windows.ico。
• 如果你是通过其他方式安装的 git：将 名称 设置为 " Git Bash "，将 命令行 设置为 C:\Program Files\Git\bin\bash.exe -i -l，并将 图标 设置为 C:\Program Files\Git\mingw64\share\git\git-for-windows.ico。

设置 起始目录 为 %USERPROFILE%，并确保 从下拉菜单隐藏配置文件 设置为 " 关闭 "（否则你将无法在下拉菜单中看到此配置文件）。

现在保存您的更改。

您将使用此配置文件在此 bash shell 中运行ani-cli。在 Windows 终端设置中的启动下，您可以将此配置文件设置为默认值，这样每次想运行ani-cli时就无需切换到它。

现在重新启动 Windows 终端。在 Git Bash 配置文件中，通过运行以下命令安装ani-cli。

勺子 桶 添加额外材料
scoop 安装 ani-cli

接下来，安装其依赖项。

勺子 桶 添加额外材料
scoop 安装 fzf ffmpeg mpv

还可以考虑安装yt-dlp以使下载功能正常工作。

重新启动 Windows 终端。进入 Git Bash 配置文件，并使用ani-cli -U更新ani-cli。您将使用此命令保持 ani-cli 最新。

现在您可以使用 ani-cli。阅读ani-cli -h的输出以获取更多帮助。

Windows：已知问题及解决方案

如果您遇到问题，请使用ani-cli -U将 ani-cli 更新到最新版本。如果问题仍然存在，请继续阅读。

• 卡在 " 搜索动画：" 。如果你使用上面描述的 Windows 终端 Bash 设置，本不应该发生这种情况。它发生在你使用 Git Bash 终端（即 mintty 终端）时。这是 fzf 和 mintty 之间的问题，应该会在 fzf 的未来版本中解决。目前，或者使用上面描述的 Windows 终端设置，或者如果你坚持使用 mintty 终端，在运行 ani-cli 之前运行 export MSYS=enable_pcon 。
• " 没有此类文件或目录 " 或与 WSL 相关的错误：如果你按照上面描述的 Windows Terminal Bash 设置操作，这不应该发生。此问题发生在你在 PowerShell 或 cmd 中运行 ani-cli 时。这是因为调用了 WSL 的 bash.exe，而不是 Git for Windows 的 bash.exe，在 %USERPROFILE%\scoop\shims\ani-cli.cmd 中。如果你必须使用 PowerShell 或 cmd，请编辑 %USERPROFILE%\scoop\shims\ani-cli.cmd 文件。在文件资源管理器中，进入 C:\Users\USERNAME\scoop\shims 目录，并用记事本打开 ani-cli.cmd 文件。接下来：
  • 如果你使用 scoop 安装了 git，请将 @bash 替换为 @"%GIT_INSTALL_ROOT%\bin\bash.exe"，或者
  • 如果你通过其他方式安装了 git，请用 @"C:\Program Files\Git\bin\bash.exe" 替换 @bash。
    如果 ani-cli 的 scoop 清单在 这个 PR 中得到更新，这个问题应该会被修复。
• curl 可能会引起问题。ani-cli 在 7.83.1 版本的 curl 上测试失败，而在 7.86.0 版本上测试成功。如果遇到问题，尝试使用 scoop 安装更新版本。
• 如果你使用 scoop 安装了 mpv，你的 mpv 配置将会从 C:\Users\USERNAME\scoop\apps\mpv\current\portable_config 读取。请参阅 mpv 文档 关于 portable_config 的更多详细信息。

请按照你的 Linux 发行版的安装说明进行操作。

请注意，媒体播放器（mpv 或 vlc）需要安装在 Windows 上，而不是 WSL 上。关于这一点的说明，请参见评论中的理由 （这里）。在该链接的评论中还包含了如何从 WSL 使用媒体播放器的说明。

在 Windows 上安装媒体播放器时，请确保其在 Windows 的 Path 中。确保这一点的简单方法是使用包管理器（在 Windows 上，而不是 WSL）下载媒体播放器，比如 scoop。

从应用商店安装 iSH 和 VLC。

确保使用以下方式更新 apk：

猫  >  /etc/apk/repositories  <  < 'EOF'
https://dl-cdn.alpinelinux.org/alpine/edge/main https://dl-cdn.alpinelinux.org/alpine/edge/community https://dl-cdn.alpinelinux.org/alpine/edge/testing
EOF

apk 更新 apk 添加 --升级 apk-工具 apk 升级 --可用

更多详情：https://github.com/ish-app/ish/issues/2530

然后运行这个命令：

apk 添加 grep sed curl-impersonate bash fzf git ncurses patch ffmpeg
git 克隆 --depth 1 https://github.com/pystardust/ani-cli ~/.ani-cli cp ~/.ani-cli/ani-cli /usr/local/bin/ani-cli chmod  x /usr/local/bin/ani-cli rm -rf ~/.ani-cli

在 iOS 的 iSH 中下载时，省略常用的 -d 标志，改为在 VLC 中选择下载选项：

复制粘贴脚本：

• 切换到桌面模式（STEAM按钮 > 电源 > 切换到桌面）
• 打开Konsole（左下角Steam Deck图标 > 系统 > Konsole）
• 复制脚本，将其粘贴到命令行界面并按回车键（在 Steam Deck 上按 " A " 按钮）

[ ! -d ~/.local/bin ] && mkdir ~/.local/bin && echo "export PATH=$HOME/.local/bin:\$PATH" >> ".$(echo $SHELL | sed -nE "s|.*/(.*)\$|\1|p")rc"

git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install

curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/.local/bin/yt-dlp
chmod +x ~/.local/bin/yt-dlp

mkdir ~/.patch
curl -o ~/.patch/patch.tar.zst https://mirror.sunred.org/archlinux/core/os/x86_64/patch-2.8-1-x86_64.pkg.tar.zst
tar xvf ~/.patch/patch.tar.zst -C ~/.patch/
cp ~/.patch/usr/bin/patch ~/.local/bin/

git clone https://github.com/pystardust/ani-cli.git ~/.ani-cli
cp ~/.ani-cli/ani-cli ~/.local/bin/

flatpak 安装 io.mpv.Mpv

press enter("A" button on Steam Deck) on questions

安装分步骤：

安装mpv（Flatpak版本）：

flatpak install io.mpv.Mpv

press enter("A" button on Steam Deck) on questions

Install fzf:

git clone --depth 1 https://github.com/junegunn/fzf.git ~/.fzf
~/.fzf/install

press enter("A" button on Steam Deck) on questions

不存在，可以创建一个 ~/.local/bin 文件夹并添加到$PATH

[ ! -d ~/.local/bin ] && mkdir ~/.local/bin && echo "export PATH=$HOME/.local/bin:\$PATH" >> ".$(echo $SHELL | sed -nE "s|.*/(.*)\$|\1|p")rc"

安装 yt-dlp（仅下载功能需要）：

curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/.local/bin/yt-dlp
chmod +x ~/.local/bin/yt-dlp

安装 patch（自我更新功能 [ -U ] 所需）：

mkdir ~/.patch
curl -o ~/.patch/patch.tar.zst https://mirror.sunred.org/archlinux/core/os/x86_64/patch-2.8-1-x86_64.pkg.tar.zst
tar xvf ~/.patch/patch.tar.zst -C ~/.patch/
cp ~/.patch/usr/bin/patch ~/.local/bin/

安装 ani-cli：

git 克隆  https://github.com/pystardust/ani-cli.git  ~/.ani-cli
cp ~/.ani-cli/ani-cli ~/.local/bin/

可选：添加桌面快捷方式：

echo '[桌面入口]
Encoding=UTF-8
Type=Application
Exec=bash -c "source $HOME/.'$(echo $SHELL | sed -nE "s|.*/(.*)\$|\1|p")'rc && konsole --fullscreen -e ani-cli"
Name=ani-cli' > $HOME/.local/share/applications/ani-cli.desktop

该 .desktop 条目将允许直接在 Konsole 中从 " 游戏模式 " 启动 ani-cli 在 Steam 桌面应用中： 添加游戏 > 添加非 Steam 游戏 > 勾选 ani-cli > 添加选定的程序

复制粘贴脚本：

sudo pkg 安装 mpv fzf yt-dlp patch git
git clone "https://github.com/pystardust/ani-cli.git"
sudo cp ani-cli/ani-cli /usr/local/bin
rm -rf ani-cli

分步骤安装：

安装依赖项：

sudo pkg install mpv fzf yt-dlp patch

安装 ani-cli：

如果你还没有安装 git，请安装它

sudo pkg 安装 git

从源代码安装：

git clone " https://github.com/pystardust/ani-cli.git "
sudo cp ani-cli/ani-cli /usr/local/bin
rm -rf ani-cli

注意：mpv处于桌面模式，所以在手机上操作有点困难。

问题是你需要安装并使用 nix 才能使其工作，为此你需要使用 NixManager（图形界面）或 crackle（命令行界面）。我们将在 copypaste 脚本中使用 crackle，但你可以随意选择其中一个。

复制粘贴脚本：

wget -q -O -  https://github.com/tuxecure/crackle/releases/latest/download/upgradefunc|  bash -s setup
crackle 安装 ani-cli mpv

这也可以通过 NixManager 实现，我个人的建议是使用 NixManager，因为在手机上使用 GUI 更加方便。

• 易于：

  sudo apt 删除 ani-cli
  
  # 从 apt 中删除仓库
  sudo rm -f /etc/apt/trusted.gpg.d/ani-cli.asc /etc/apt/sources.list.d/ani-cli-debian.list

• dnf:

  sudo dnf remove ani-cli      # 用于 ani-cli
  
  # 在 dnf 中禁用仓库
  dnf copr 禁用 derisis13/ani-cli

  如果你不使用它，可能想要卸载 RPM fusion

• zypper:

  zypper 移除 ani-cli
  zypper removerepo ani-cli

  如果你不需要 packman-essentials，你可能想要将其移除

• AUR:

  yay -R ani-cli

• 铲子：

  scoop 卸载 ani-cli

• Linux：

  sudo rm "/usr/local/bin/ani-cli"

• 电脑:

  brew 卸载 ani-cli && brew 取消 tap pystardust/ani-cli

• Windows：在 Git Bash 中以管理员身份运行：

  rm "/usr/bin/ani-cli"

• Termux 软件包

  包移除 ani-cli

• 安卓：

  rm "$PREFIX/bin/ani-cli"

• 蒸汽甲板

  rm "~/.local/bin/ani-cli"
  rm -rf ~/.ani-cli

  可选：移除依赖项：

  rm ~/.local/bin/yt-dlp
  rm -rf "~/.fzf"
  flatpak 卸载 io.mpv.Mpv

• iOS

  rm -rf /usr/local/bin/ani-cli

  要卸载其他依赖项：

  apk 删除 grep sed curl fzf git ffmpeg ncurses

• 我可以更改字幕语言或关闭字幕吗？ - 字幕是一个单独的英文轨道提供给播放器，因此您可以在那里切换它们（mpv：按v）。不提供其他语言。
• 我可以看配音版吗？ - 可以，使用 --dub。
• 我可以更改配音语言吗？- 不可以。
• 我可以更改媒体来源吗？ - 不可以（除非你自己可以抓取该来源）。
• 我可以使用 vlc 吗？- 可以，使用 --vlc 或 export ANI_CLI_PLAYER=vlc。
• 我可以调整分辨率吗？- 可以，使用 -q 分辨率，例如 ani-cli -q 1080。
• 我如何下载？- 使用 -d，它会下载到您的工作目录。
• 我可以更改下载文件夹吗？- 可以，将 ANI_CLI_DOWNLOAD_DIR 设置为您想要的位置。
• 我如何批量下载？ - 使用 -d -e 首集-末集，例如 ani-cli onepiece -d -e 1-1000。

注意： 所有功能都在 ani-cli --help 中有文档说明。