jxxghp/MoviePilot
MoviePilot
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.
Features
- Library Organization Automation - Automates the discovery, downloading, renaming, and organization of movie and television content for NAS systems.
- Model Context Protocol Integrations - Implements the Model Context Protocol to expose internal media management tools to external AI agents.
- LLM Media Agents - Acts as an LLM-driven agent that processes conversational text to control media subscriptions and organization.
- LLM Tool Calling - Implements a tool-calling protocol that maps natural language user intent to specific internal media management functions.
- Model Context Protocol Servers - Functions as a Model Context Protocol server to expose media management capabilities to external AI clients.
- Natural Language Media Controllers - Provides an AI-driven interface for controlling media discovery and library management via natural language conversational commands.
- Media Organization - Automatically renames, sorts, and moves downloaded media files into a structured library based on configurable rules.
- Event-Driven Workflow Orchestrators - Orchestrates sequential media workflows including searching, downloading, and organizing based on system and file events.
- Media Downloaders - Manages download directories and allows users to trigger the retrieval of media resources from online sources.
- Media Metadata Enrichments - Automatically fetches and refreshes metadata for movie and TV collections to keep the library organized.
- Content Subscriptions - Tracks desired media and automatically triggers searches and downloads for new releases or updates.
- NAS Media Automation - Automates the full lifecycle of media discovery, downloading, and organization on NAS devices.
- Self-Hosted Media Managers - Coordinates complex workflows between downloaders, metadata scrapers, and storage to manage private media collections.
- Movie and Show Metadata - Retrieves movie and television metadata from external databases to organize and rename local media files.
- Unified Media Search - Searches across multiple configured indexers and sites to locate specific media items and their available resources.
- Event-Driven Workflow Triggers - Triggers automated organization and renaming workflows based on file system changes and download status events.
- Automation Orchestration - Coordinates the end-to-end lifecycle of media from discovery and downloading to final library organization.
- Conversational Control - Provides a conversational AI interface to control media subscriptions, searches, and file organization via text commands.
- File System Monitors - Watches directory changes and download completions to trigger automated file organization and renaming workflows.
- Model Context Protocol - Implements the Model Context Protocol to expose internal media library data and tools to external AI clients.
- External API Tool Exposures - Exposes internal media management functions as callable tools via protocol endpoints for AI agent interaction.
- External Agent Integrations - Provides standardized interfaces to link the media orchestrator with third-party AI agents for remote control and expansion.
- Media Server Plugins - Provides a framework for developing modular extensions to add custom automation logic to the media server.
- Dynamic Logic Modules - Allows the integration of custom extensions into the running environment without requiring a full application rebuild.
- Media Pipeline Extensions - Combines custom plugins and AI agents to extend the automated media management pipeline.
- Plugin-Extensible Runtimes - Utilizes a runtime that allows core automation logic to be extended via external plugins.
- Plugin Development Frameworks - Offers a development framework and APIs for creating and integrating third-party plugins.
- Programmatic Plugin Loading - Supports the dynamic loading of external plugin modules into the runtime environment without requiring a system restart.
- Plugin-Based Architectures - Implements an architecture that allows extending core automation functionality via external modules.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
