ani-cli 新手入门：3 步在终端里搜索、选集、播放，一个命令追番的完整指南

ani-cli 新手入门：3 步在终端里搜索、选集、播放，一个命令追番的完整指南

【免费下载链接】ani-cliA cli tool to browse and play anime项目地址: https://gitcode.com/gh_mirrors/an/ani-cli

ani-cli是一个开源的命令行动漫追番工具，支持在 Linux、macOS、Windows、Android 等平台上搜索动漫、选择集数、直接播放，还能续播、批量下载和画质切换。本文带你完成从安装到追番的完整流程。

它的工作思路非常清晰：输入关键词 → 从搜索结果中选择作品 → 选择集数 → 交给 mpv / VLC / IINA 等播放器播放：

一键安装步骤：ani-cli 最快上手方法

ani-cli 依赖fzf（交互菜单）、mpv或vlc（播放器）以及curl，各平台都有现成渠道：

macOS 的 Homebrew 配方见 Formula/ani-cli.rb，可一并装上 IINA 播放器。

Windows 用户注意：配置 Git Bash 终端

Windows 上建议用 Windows Terminal + Git Bash 运行 ani-cli。在 Terminal 的Settings > Profiles中点击Add a new profile：

填写配置：名称Git Bash，命令行%GIT_INSTALL_ROOT%\bin\bash.exe -i -l，起始目录%USERPROFILE%，并关闭 "Hide profile from dropdown"：

然后在 Git Bash 里执行scoop install ani-cli fzf ffmpeg mpv，重启终端即可使用。

搜索与播放：输入一个关键词开始追番

打开终端输入ani-cli，会出现Search anime:提示符，输入例如frieren，回车后弹出 fzf 列表，方向键选择作品，再选集数，播放器随即自动打开，英文字幕自动加载。

也可以把关键词直接写在命令里：

ani-cli frieren ani-cli blue lock -e 5 # 直接指定第 5 集 ani-cli one piece -e 1-10 # 批量连播第 1 到 10 集

-e支持单个集数、区间（1-10）和多选（-e "5 6"），集数写0表示第一集、-1表示最新集。

续播历史：用 -c 一键回到上次的进度

ani-cli 会自动记录观看历史。下次只需输入：

ani-cli -c

即可从历史列表中选择"上次看到第几集"的动漫继续观看。历史默认存放在~/.local/state/ani-cli/下，可用-D清空历史、-l查看播放日志。

播放菜单操作：next、replay、previous 全部掌握

播放启动后，终端里会出现一个循环菜单，随时可以操作（核心逻辑见 ani-cli）：

也就是说，一个ani-cli命令就能完成"搜索 → 选集 → 播放 → 切集 → 再切集"的全流程，无需离开终端。

进阶技巧：下载、画质、配音与同步追番

几个高频实用参数（完整说明运行ani-cli -h，手册见 ani-cli.1）：

• 下载：ani-cli frieren -d -e 1-10，文件保存到当前目录（依赖 yt-dlp 或 ffmpeg）
• 指定画质：-q 1080/-q 720，默认best
• 看英语配音版：加--dub（默认是字幕版 sub）
• 换播放器：-v使用 VLC；macOS 默认优先 IINA
• 同步追番：-s通过 Syncplay 和朋友一起看（仅 mpv）
• 自动跳片头：--skip，需安装 ani-skip 同类工具
• 自更新：ani-cli -U

此外还有一组环境变量可做全局配置，比如ANI_CLI_QUALITY固定画质、ANI_CLI_DOWNLOAD_DIR指定下载目录、ANI_CLI_PLAYER换播放器，详见手册的 ENVIRONMENT VARIABLES 一节。

常见问题快速排查

• 提示 Blocked by cloudflare：安装curl-impersonate即可绕过；
• 搜索卡在 "Search anime:" 不动（Windows）：说明你在 mintty 版 Git Bash 里运行，请改用 Windows Terminal + Git Bash 方案；
• 其他异常：先执行ani-cli -U升级到最新版。

更多玩法可以阅读 hacking.md 了解抓取原理，或通过 matrix.md 加入 ani-cli 的 Matrix 社区与其他用户交流。

⚠️ 本项目内容来自第三方网站，请遵守当地法律法规，风险自担（详见 disclaimer.md）。

【免费下载链接】ani-cliA cli tool to browse and play anime项目地址: https://gitcode.com/gh_mirrors/an/ani-cli