# jxxghp/moviepilot

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/jxxghp-moviepilot).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

11,254 stars · 1,403 forks · Python · GPL-3.0

## Links

- GitHub: https://github.com/jxxghp/MoviePilot
- Homepage: https://movie-pilot.org
- awesome-repositories: https://awesome-repositories.com/repository/jxxghp-moviepilot.md

## Description

MoviePilot is a self-hosted media orchestrator and NAS media library automator. It coordinates workflows between downloaders, metadata scrapers, and file systems to automate the discovery, downloading, renaming, and organization of movie and television content.

The system functions as an LLM media management agent, allowing users to control subscriptions, searches, and file organization through conversational text commands. It also acts as a Model Context Protocol server, exposing internal media management tools via a standardized interface for external AI clients and agents.

The project includes a plugin-based automation framework that supports dynamic module loading and a hot-reloading architecture for extending system logic. Additional capabilities include automated content subscriptions, event-driven media monitoring, metadata scraping pipelines, and configurable event notifications across messaging platforms.

The system provides health diagnostics for configuration recovery and supports custom interface styling via CSS.

## Tags

### Content Management & Publishing

- [Library Organization Automation](https://awesome-repositories.com/f/content-management-publishing/media-management/media-servers/library-organization-automation.md) — Automates the discovery, downloading, renaming, and organization of movie and television content for NAS systems.
- [Media Metadata Enrichments](https://awesome-repositories.com/f/content-management-publishing/ebook-metadata-enrichments/media-metadata-enrichments.md) — Automatically fetches and refreshes metadata for movie and TV collections to keep the library organized. ([source](https://cdn.jsdelivr.net/gh/jxxghp/moviepilot@v2/README.md))
- [Content Subscriptions](https://awesome-repositories.com/f/content-management-publishing/media-management/media-automation-tools/content-subscriptions.md) — Tracks desired media and automatically triggers searches and downloads for new releases or updates. ([source](https://wiki.movie-pilot.org/))
- [NAS Media Automation](https://awesome-repositories.com/f/content-management-publishing/media-management/media-servers/nas-media-automation.md) — Automates the full lifecycle of media discovery, downloading, and organization on NAS devices.
- [Self-Hosted Media Managers](https://awesome-repositories.com/f/content-management-publishing/media-management/self-hosted-media-managers.md) — Coordinates complex workflows between downloaders, metadata scrapers, and storage to manage private media collections.
- [Movie and Show Metadata](https://awesome-repositories.com/f/content-management-publishing/metadata-tagging/bookmark-metadata-managers/automated-metadata-fetching/media-metadata-fetching/movie-and-show-metadata.md) — Retrieves movie and television metadata from external databases to organize and rename local media files.
- [Media Server Plugins](https://awesome-repositories.com/f/content-management-publishing/media-server-plugins.md) — Provides a framework for developing modular extensions to add custom automation logic to the media server.

### Artificial Intelligence & ML

- [Model Context Protocol Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-assistant-integrations/model-context-protocol-integrations.md) — Implements the Model Context Protocol to expose internal media management tools to external AI agents.
- [LLM Media Agents](https://awesome-repositories.com/f/artificial-intelligence-ml/llm-media-agents.md) — Acts as an LLM-driven agent that processes conversational text to control media subscriptions and organization.
- [LLM Tool Calling](https://awesome-repositories.com/f/artificial-intelligence-ml/llm-tool-calling.md) — Implements a tool-calling protocol that maps natural language user intent to specific internal media management functions.
- [Model Context Protocol Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/model-context-protocol-servers.md) — Functions as a Model Context Protocol server to expose media management capabilities to external AI clients.
- [Natural Language Media Controllers](https://awesome-repositories.com/f/artificial-intelligence-ml/natural-language-media-controllers.md) — Provides an AI-driven interface for controlling media discovery and library management via natural language conversational commands. ([source](https://cdn.jsdelivr.net/gh/jxxghp/moviepilot@v2/README.md))
- [Model Context Protocol](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/model-integration-interfaces/model-context-protocol.md) — Implements the Model Context Protocol to expose internal media library data and tools to external AI clients.
- [External API Tool Exposures](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-agent-integrations/ai-agent-tool-integrations/external-api-tool-exposures.md) — Exposes internal media management functions as callable tools via protocol endpoints for AI agent interaction. ([source](https://cdn.jsdelivr.net/gh/jxxghp/moviepilot@v2/README.md))
- [External Agent Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/external-agent-integrations.md) — Provides standardized interfaces to link the media orchestrator with third-party AI agents for remote control and expansion. ([source](https://wiki.movie-pilot.org/))

### Part of an Awesome List

- [Media Organization](https://awesome-repositories.com/f/awesome-lists/devtools/media-organization.md) — Automatically renames, sorts, and moves downloaded media files into a structured library based on configurable rules. ([source](https://wiki.movie-pilot.org/))

### Business & Productivity Software

- [Event-Driven Workflow Orchestrators](https://awesome-repositories.com/f/business-productivity-software/event-driven-workflow-orchestrators.md) — Orchestrates sequential media workflows including searching, downloading, and organizing based on system and file events.
- [Media Downloaders](https://awesome-repositories.com/f/business-productivity-software/media-downloaders.md) — Manages download directories and allows users to trigger the retrieval of media resources from online sources. ([source](https://wiki.movie-pilot.org/))

### Data & Databases

- [Unified Media Search](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-and-indexing/cross-account-search/unified-media-search.md) — Searches across multiple configured indexers and sites to locate specific media items and their available resources. ([source](https://wiki.movie-pilot.org/))

### Development Tools & Productivity

- [Event-Driven Workflow Triggers](https://awesome-repositories.com/f/development-tools-productivity/event-driven-workflow-triggers.md) — Triggers automated organization and renaming workflows based on file system changes and download status events.
- [Dynamic Logic Modules](https://awesome-repositories.com/f/development-tools-productivity/centralized-shell-configurations/module-loading-systems/dynamic-logic-modules.md) — Allows the integration of custom extensions into the running environment without requiring a full application rebuild.

### DevOps & Infrastructure

- [Automation Orchestration](https://awesome-repositories.com/f/devops-infrastructure/automation-orchestration.md) — Coordinates the end-to-end lifecycle of media from discovery and downloading to final library organization.
- [Media Pipeline Extensions](https://awesome-repositories.com/f/devops-infrastructure/cicd-pipeline-automation/core-build-engines/bundling-extension-architectures/plugin-extension-architectures/media-pipeline-extensions.md) — Combines custom plugins and AI agents to extend the automated media management pipeline. ([source](https://cdn.jsdelivr.net/gh/jxxghp/moviepilot@v2/README.md))
- [Plugin-Extensible Runtimes](https://awesome-repositories.com/f/devops-infrastructure/release-automation/plugin-extensibility/plugin-extensible-runtimes.md) — Utilizes a runtime that allows core automation logic to be extended via external plugins.

### Graphics & Multimedia

- [Conversational Control](https://awesome-repositories.com/f/graphics-multimedia/ai-powered-media-organization/conversational-control.md) — Provides a conversational AI interface to control media subscriptions, searches, and file organization via text commands.

### System Administration & Monitoring

- [File System Monitors](https://awesome-repositories.com/f/system-administration-monitoring/file-system-monitors.md) — Watches directory changes and download completions to trigger automated file organization and renaming workflows.

### Software Engineering & Architecture

- [Plugin Development Frameworks](https://awesome-repositories.com/f/software-engineering-architecture/integration-extensibility/extensibility/third-party-plugins/plugin-development-frameworks.md) — Offers a development framework and APIs for creating and integrating third-party plugins. ([source](https://wiki.movie-pilot.org/))
- [Programmatic Plugin Loading](https://awesome-repositories.com/f/software-engineering-architecture/plugin-architectures/programmatic-plugin-loading.md) — Supports the dynamic loading of external plugin modules into the runtime environment without requiring a system restart.
- [Plugin-Based Architectures](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/plugin-module-systems/modular-plugin-architectures/plugin-based-architectures.md) — Implements an architecture that allows extending core automation functionality via external modules.
