Jellyfin Migrator 项目使用教程

1. 项目的目录结构及介绍

Jellyfin Migrator 项目的目录结构如下：

Jellyfin-Migrator/
├── README.md
├── LICENSE
├── migrator.py
├── config.yaml
└── scripts/
    └── example_script.py

目录结构介绍

• README.md: 项目说明文档，包含项目的基本信息和使用方法。
• LICENSE: 项目的开源许可证文件，本项目使用 GNU Affero General Public License。
• migrator.py: 项目的启动文件，负责执行数据库迁移的主要逻辑。
• config.yaml: 项目的配置文件，包含迁移过程中需要用到的各种配置参数。
• scripts/: 存放辅助脚本的目录，例如 example_script.py 是一个示例脚本。

2. 项目的启动文件介绍

migrator.py

migrator.py 是 Jellyfin Migrator 项目的启动文件，负责执行数据库迁移的主要逻辑。以下是该文件的主要功能和结构：

import yaml
from migrator import Migrator

def main():
    # 读取配置文件
    with open('config.yaml', 'r') as file:
        config = yaml.safe_load(file)
    
    # 初始化 Migrator 对象
    migrator = Migrator(config)
    
    # 执行迁移
    migrator.migrate()

if __name__ == "__main__":
    main()

主要功能

• 读取 config.yaml 配置文件。
• 初始化 Migrator 对象。
• 调用 Migrator 对象的 migrate 方法执行数据库迁移。

3. 项目的配置文件介绍

config.yaml

config.yaml 是 Jellyfin Migrator 项目的配置文件，包含迁移过程中需要用到的各种配置参数。以下是一个示例配置文件的内容：

source:
  database_path: /path/to/source/database
  media_path: /path/to/source/media

destination:
  database_path: /path/to/destination/database
  media_path: /path/to/destination/media

options:
  preserve_watched_status: true
  preserve_metadata: true

配置参数介绍

• source: 源数据库和媒体文件的路径。
  • database_path: 源数据库的路径。
  • media_path: 源媒体文件的路径。
• destination: 目标数据库和媒体文件的路径。
  • database_path: 目标数据库的路径。
  • media_path: 目标媒体文件的路径。
• options: 迁移选项。
  • preserve_watched_status: 是否保留观看状态。
  • preserve_metadata: 是否保留元数据。

通过以上配置文件，用户可以自定义迁移过程中的各种参数，以满足不同的需求。