MoviePilot-V3

MoviePilot-V3

Docker app from doudou1234's Repository

Overview

MoviePilot V3 is an automation hub for a home media library. It watches your subscriptions, searches your indexers, hands the release to your existing BitTorrent client, then renames, hardlinks and scrapes the finished files into a clean library and refreshes your media server.

Highlights:
- Subscribe to movies and TV shows and let MoviePilot find and download them automatically.
- Works with your existing downloaders, media servers, metadata sources and notification channels.
- Automatic organising: renaming, hardlinking, NFO/artwork scraping and media server refresh.
- Plugin and workflow system for extending behaviour without touching the core.

Setup notes:
- The web UI runs on port 3000. On first start open it and complete the setup wizard.
- Map /media and /downloads under the same Unraid share (for example /mnt/user/) so hardlinks work instead of copies.
- Settings live in /config/app.env and can also be edited from the web UI.

Documentation: https://wiki.movie-pilot.org
Project home: https://movie-pilot.org

This template is community maintained and is not produced by the MoviePilot authors. Support requests for the template belong in the Unraid support thread; bugs in MoviePilot itself belong upstream.

===== 简体中文 =====
MoviePilot V3 是一款面向家庭影音库的自动化管理工具:自动订阅、搜索资源、调用已有的 BT 下载器下载,下载完成后自动重命名、硬链接、刮削元数据并通知媒体服务器刷新。

使用提示:
- Web 界面端口为 3000,首次启动后打开页面完成初始化向导。
- /media 与 /downloads 请映射到同一个 Unraid 共享(例如 /mnt/user/)下,否则无法硬链接,只能复制。
- 配置保存在 /config/app.env,也可以在 Web 界面中修改。

本模板由社区维护,非 MoviePilot 官方出品。模板相关问题请在 Unraid 支持贴反馈,程序本身的问题请到上游仓库反馈。

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

主要特性

  • 聚焦影视自动化的核心流程:订阅、搜索、下载、整理、刮削、媒体库刷新与消息通知。
  • 前后端分离,后端基于 FastAPI,前端基于 Vue 3,部署和扩展边界更清晰。
  • 支持下载器、媒体服务器、元数据源、消息渠道、插件、工作流和 AI Agent 等能力组合。
  • 更完整的功能介绍、截图和使用入口见官网:https://movie-pilot.org

安装使用

推荐优先使用 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。常用入口:

相关项目

免责申明

  • 本软件仅供学习交流使用,任何人不得将本软件用于商业用途,任何人不得将本软件用于违法犯罪活动,软件对用户行为不知情,一切责任由使用者承担。
  • 本软件代码开源,基于开源代码进行修改,人为去除相关限制导致软件被分发、传播并造成责任事件的,需由代码修改发布者承担全部责任,不建议对用户认证机制进行规避或修改并公开发布。
  • 本项目不接受捐赠,没有在任何地方发布捐赠信息页面,软件本身不收费也不提供任何收费相关服务,请仔细辨别避免误导。

贡献者

Install MoviePilot-V3 on Unraid in a few clicks.

Find MoviePilot-V3 in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for MoviePilot-V3 Review the template variables and paths Click Install

Download Statistics

53,010
Total Downloads

Related apps

Details

Repository
jxxghp/moviepilot-v3
Last Updated2026-08-20
First Seen2026-08-20

Runtime arguments

Web UI
http://[IP]:[PORT:3000]/
Network
bridge
Shell
bash
Privileged
false

Template configuration

WebUI PortPorttcp

Port for the MoviePilot web interface.

Target
3000
Default
3000
Value
3000
ConfigPathrw

Configuration, database and cache. Keep this on the cache/appdata share.

Target
/config
Default
/mnt/user/appdata/moviepilot-v3
Value
/mnt/user/appdata/moviepilot-v3
Media LibraryPathrw

Your media library, e.g. /mnt/user/media/. Must be on the same share as the download folder if you want hardlinks.

Target
/media
DownloadsPathrw

The download folder used by your BitTorrent client, e.g. /mnt/user/downloads/. Must be on the same share as the media library if you want hardlinks.

Target
/downloads
PUIDVariable

User ID the application runs as. 99 is the standard Unraid nobody user.

Default
99
Value
99
PGIDVariable

Group ID the application runs as. 100 is the standard Unraid users group.

Default
100
Value
100
UMASKVariable

File mode creation mask used for files written by the application.

Default
000
Value
000
TZVariable

Container timezone, e.g. Asia/Shanghai, Europe/Berlin, America/New_York.

Default
Asia/Shanghai
Value
Asia/Shanghai
NGINX_PORTVariable

Port the built-in web server listens on inside the container. Change this only together with the WebUI Port mapping above.

Default
3000
Value
3000
PORTVariable

Internal API port. Only change this if it clashes with something else inside the container.

Default
3001
Value
3001
MOVIEPILOT_AUTO_UPDATEVariable

Update the application on container start: release, dev, or false to disable.

Default
release
Value
release
PROXY_HOSTVariable

Optional HTTP proxy used for outbound requests, e.g. http://user:password@192.168.1.2:7890

GITHUB_PROXYVariable

Optional GitHub mirror prefix used when downloading updates and plugins, e.g. https://ghproxy.net/

GITHUB_TOKENVariable

Optional GitHub personal access token used to raise the API rate limit for updates and plugin downloads.

MOVIEPILOT_FORCE_CHOWNVariable

Set to true for one start if the application reports permission errors on its cache directories. Slows down startup.

Default
false
Value
false
Docker SocketPathrw

Optional. Only needed by plugins that restart containers. Leave empty unless you use one of them.

Target
/var/run/docker.sock