MoviePilot is a NAS media library automation tool that handles subscription, search, download, organization, metadata scraping, library refresh, and notification workflows for film and television content.
The tool addresses the challenge of maintaining organized media libraries on network-attached storage by automating the core processes involved in acquiring and managing content. It achieves this through a decoupled architecture with a FastAPI backend and Vue 3 frontend, allowing users to combine various capabilities including multiple downloader integrations, media server support, metadata sources, notification channels, plugins, workflows, and AI agent functionality. The system includes built-in agent capabilities that enable natural language interaction to perform management tasks like searching, subscribing, downloading, organizing, and troubleshooting.
Adoption suits users running NAS environments on Windows, Linux, or Synology systems who want to eliminate manual steps in media library management. Docker deployment is the recommended approach, with separate images available for different versions. The tool is designed for extensibility and maintenance clarity through its separated frontend and backend layers, making it suitable for users who may want to customize or extend functionality. The project documentation, including setup guides for PostgreSQL, Docker Compose examples, and CLI management tools, is maintained in an official wiki.
The project maintains active development with structured contribution guidelines requiring developers to review repository rules and local environment documentation before submitting changes. The codebase includes comprehensive documentation for custom skill creation and MCP client integration, indicating ongoing investment in extensibility patterns. Multiple deployment options are actively supported through distinct Docker images for different versions, and the project provides migration documentation for version upgrades.
