MoviePilot README

The project's README from github.com/jxxghp/MoviePilot. As one markdown file: README.md.

MoviePilot

简体中文 | English

GitHub Repo stars GitHub forks GitHub contributors GitHub repo size GitHub issues Docker Pulls Docker Pulls V2 Docker Pulls V3 Platform

基于 NAStool 部分代码重新设计,聚焦自动化核心需求,减少问题同时更易于扩展和维护。

仅用于学习交流使用,请勿在任何国内平台宣传该项目!

发布频道:https://t.me/moviepilot_channel

主要特性

安装使用

推荐优先使用 Docker 部署。V3 使用独立镜像 jxxghp/moviepilot-v3,V2 和旧版镜像保持原命名。Compose 示例、环境变量、目录映射和升级方式以官方 Wiki 为准:

也可以使用本地 CLI 以源码模式安装和管理 MoviePilot:

curl -fsSL https://raw.githubusercontent.com/jxxghp/MoviePilot/v3/scripts/bootstrap-local.sh | bash

安装完成后使用 moviepilot 命令完成初始化、启动、停止、更新和配置查看。完整命令见 docs/cli.md。

Agent

  1. MoviePilot 自带智能体能力,可在完成模型配置后,通过自然语言调用系统工具,辅助完成搜索、订阅、下载、整理、排障等管理任务。

  2. 其它智能体可以导入本仓库的 skills/ 目录以获得 MoviePilot 操作能力;支持 skills CLI 的环境可使用:

    npx skills add https://github.com/jxxghp/MoviePilot
    

    内置 Skills 列表见 skills/,自定义 Skill 可参考 skills/create-moviepilot-skill/SKILL.md。

  3. 其它 MCP 客户端可以通过 MoviePilot 的 MCP 端点 /api/v1/mcp 调用工具,认证方式、客户端配置和工具 API 见 docs/mcp-api.md。

参与开发

开发前请先阅读仓库规则和本地环境说明,保持变更聚焦,通过测试后再提交 PR。常用入口:

相关项目

免责申明

贡献者

MoviePilot (jxxghp/MoviePilot)

Searching Database…

这是什么?MoviePilot 是一款自托管的自动化工具,用于管理 NAS 上的影音库。它覆盖电影和剧集的完整流程:订阅、搜索、下载、整理、刮削元数据、刷新媒体服务器,并发送通知。
这是桌面软件,还是我要在 NAS 上运行的网页服务?这是一个自托管的网页应用,采用前后端分离架构:后端基于 FastAPI,前端基于 Vue 3。它需要长期在 NAS 或服务器上运行,而不是本地桌面程序。
我该怎么安装和运行 MoviePilot?推荐使用 Docker 部署:V3 使用独立的镜像 jxxghp/moviepilot-v3(旧版 V2 仍沿用原镜像名称),Compose 示例和环境变量说明见官方 Wiki。也可以从源码安装,然后用本地的 `moviepilot` 命令行工具管理(init、start、stop、update、config)。
我需要先装好下载器或媒体服务器吗?需要。MoviePilot 是一个中枢,负责连接外部的下载器、媒体服务器、元数据源和通知渠道,还可以接入可选的插件、工作流和 AI 智能体。你需要先配置好这些服务,它才能真正对你的影音库进行操作。
使用上有哪些限制需要注意?本项目明确仅供学习研究使用,禁止商业用途和违法用途;作者也希望不要在国内中文平台上推广。此外,若重新分发修改版本,不建议绕过或修改内置的身份验证系统,由这样做的人自行承担相应责任。
内置的 Agent/AI 功能是做什么的?配置好模型后,可以用自然语言驱动 MoviePilot 内置的 AI 智能体,完成搜索、订阅、下载、整理影音库以及排查问题等操作。其他智能体可以导入 skills/ 目录,外部 MCP 客户端也可以通过 /api/v1/mcp 接口连接。
插件和相关工具放在哪里?插件单独放在 MoviePilot-Plugins 仓库中。配套项目还包括前端 MoviePilot-Frontend、共享资源 MoviePilot-Resources、服务端版本 MoviePilot-Server,以及 Rust 重写版 MoviePilot-Rust。
我能用 PostgreSQL 替代默认数据库吗?可以,PostgreSQL 是受支持的后端,具体设置步骤单独记录在 docs/postgresql-setup.md 中。
Creator
jxxghp
Size
89 MB
Stars
11.9K
Age
3y
Commits · 90 Days