MoviePilot 开源项目教程

项目介绍

MoviePilot 是一个基于 NAStool 部分代码重新设计的 NAS 媒体库自动化管理工具。该项目聚焦自动化核心需求，旨在减少问题同时更易于扩展和维护。MoviePilot 采用前后端分离架构，基于 FastAPI 和 Vue3 开发，提供了美观易用的用户界面。该项目仅用于学习交流使用，请勿在任何国内平台宣传。

项目快速启动

环境准备

确保你已经安装了以下环境：

• Python 3.7 或更高版本
• Docker（可选，但推荐）

克隆项目

git clone https://github.com/jxxghp/MoviePilot.git
cd MoviePilot

安装依赖

pip install -r requirements.txt

启动应用

# 启动后端服务
uvicorn app.main:app --reload

# 启动前端服务（假设你已经安装了 Node.js 和 npm）
cd MoviePilot-Frontend
npm install
npm run serve

访问 http://localhost:3001/docs 查看 API 文档。

应用案例和最佳实践

案例一：自动化媒体库管理

使用 MoviePilot 可以自动化管理你的 NAS 媒体库，包括自动下载、分类、命名和归档。以下是一个简单的配置示例：

media_library:
  download_path: /path/to/downloads
  archive_path: /path/to/archive
  categories:
    - name: Movies
      path: /path/to/movies
    - name: TV Shows
      path: /path/to/tvshows

最佳实践

1. 定期更新：定期检查并更新 MoviePilot 以获取最新的功能和修复。
2. 备份配置：定期备份你的配置文件，以防数据丢失。
3. 监控日志：定期检查应用日志，以便及时发现并解决问题。

典型生态项目

1. NAStool

NAStool 是 MoviePilot 的基础项目，提供了许多核心功能和模块。你可以通过以下链接了解更多信息：

NAStool GitHub 仓库

2. FastAPI

FastAPI 是一个现代、快速（高性能）的 Web 框架，用于构建 API，基于 Starlette 和 Pydantic。MoviePilot 的后端服务就是基于 FastAPI 构建的。

FastAPI 官方文档

3. Vue.js

Vue.js 是一个用于构建用户界面的渐进式 JavaScript 框架。MoviePilot 的前端项目就是基于 Vue.js 开发的。

Vue.js 官方文档

通过这些生态项目，MoviePilot 能够提供一个完整且高效的媒体库自动化管理解决方案。