Openlist-Ani
🎬 RSS Subscription → Automatic Download → AI Renaming, One-stop Anime Automation Management
Automatically obtain anime updates from related RSS feeds, download offline to the corresponding cloud drive via Openlist,
and use LLM to analyze resource names, renaming them into formats parsable by Emby / Jellyfin.
✨ Features
- 📡 Auto Anime Tracking — Automatically fetch and download RSS anime updates
- 📦 Multi-Cloud Support — Based on OpenList, supports offline downloads for PikPak, 115, etc.
- 🤖 AI Renaming — AI analyzes resource names + TMDB search to accurately get anime title, season, episode
- 💬 Smart Assistant — Mounted on Telegram Bot, use natural language to let AI help you search and download resources
- 🔔 Update Notifications — Push updates via PushPlus, Telegram, and other channels
📋 Preparation
- Deploy Openlist according to the Openlist official documentation and set up offline downloads
- Prepare RSS subscription links (e.g., Mikan Project)
- Prepare LLM API Key
🚀 Quick Start
Method 1: PIP Installation (Recommended)
1. Installation
pip install openlist-ani2. Creating the Configuration File
Create a new config.toml in the running directory and fill in the following content:
[rss]
urls = ["RSS订阅链接"][openlist]
url = "http://localhost:5244" # Openlist 访问地址
token = "" # 令牌,见「设置 → 其他 → 令牌」
download_path = "/PikPak/Anime" # 下载保存路径
offline_download_tool = "QBITTORRENT" # 离线下载工具
[llm]
openai_api_key = "" # API Key
openai_base_url = "https://api.deepseek.com/v1"
openai_model = "deepseek-chat"
完整配置项请参考 config.toml.example 及 配置说明3. 启动
openlist-ani4. (Optional) Start the AI Assistant
Run after adding the assistant configuration in the configuration file:
[assistant]
enabled = true[assistant.telegram]
bot_token = "" # 从 @BotFather 获取
allowed_users = [] # 允许的用户 ID 列表,留空则不限制
openlist-ani-assistantMethod 2: Docker Deployment
1. Prepare Files
Create in the running directory:
config.toml— Configuration file (same content as above)data/— Data directory
docker run -d \
--name openlist-ani \
--network host \
-e ENABLE_ASSISTANT=false \
-v /path/to/config.toml:/config.toml \
-v /path/to/data:/data \
twosix26/openlist-ani:latestReplace /path/to/ with your actual path.
To enable the AI assistant, setENABLE_ASSISTANTtotrueafter completing the configuration.
For detailed instructions, see Docker Deployment Guide.
Method 3: Compile from Source
#### Prerequisite: Install uv
Linux / macOS | Windows |
更多安装方式参考 uv 官方文档
#### 步骤
# 1. 克隆仓库
git clone https://github.com/TwooSix/Openlist-Ani.git && cd Openlist-Ani2. 切换到最新版本(master 为开发分支,不保证稳定)
git checkout v* # 替换为最新版本号3. 安装依赖
uv sync --no-dev --frozen4. 创建 config.toml 并填写配置(内容同上)
5. 启动
uv run openlist-ani6.(可选)启动 AI 助理
uv run openlist-ani-assistant📖 Documentation
- Quick Start
- PIP Installation Guide
- Docker Deployment Guide
- Source Code Compilation Guide
- Configuration Instructions
🖼️ Demo
| Rename Result | Intelligent Assistant |
| :---: | :---: |
|
|
|
--- Tranlated By Open Ai Tx | Last indexed: 2026-04-11 ---