Repolode
提交项目
Kometa-Team

Kometa-Team/Kometa

基于 Python 的脚本，用于更新 Plex 媒体库的元数据，并借助 TMDb、IMDb 等来源自动创建合集和播放列表。

在 GitHub 查看官网
Star
3,460
Fork
376
未关闭 Issue
18
最近提交
19小时前

这是什么？

Kometa 是一个面向 Plex 媒体服务器的 Python 脚本，可更新电影、剧集和音乐的封面、标题、简介等元数据，并基于 TMDb、IMDb 等来源自动创建合集和播放列表。

合集与叠加效果通过配置文件定义。项目提供名为 Kometa Defaults 的模块化预设文件，用户无需逐个手写即可套用整理好的合集和叠加方案。它还可以与 Sonarr、Radarr 集成，实现媒体库的自动扩充。

元数据存放在媒体服务器之外，因此数据库丢失后可以重新应用自定义设置，也便于在不同服务器之间迁移。Kometa 支持 Windows、macOS、Linux 以及 Docker 部署，并提供 unRAID、Kubernetes、QNAP、Synology 等平台的安装指南。

核心功能

  • 01更新 Plex 中的封面、标题、简介等元数据。
  • 02基于 TMDb、IMDb 等来源自动生成合集和播放列表。
  • 03提供模块化的预设合集与叠加文件（Kometa Defaults）。
  • 04在海报上添加叠加标识，展示剧集或电影状态。
  • 05可与 Sonarr、Radarr 集成。
  • 06支持本地运行或通过 Docker 部署。

适用场景

  • 将 Plex 媒体库整理为热门、类型、年代或制作公司等合集。
  • 在媒体服务器数据库丢失后，保留并重新应用自定义封面和元数据。
  • 为大型媒体库的海报统一添加状态或评分叠加标识。
  • 通过连接 Sonarr 和 Radarr 实现媒体库的自动扩充。

快速上手

  1. 1

    按照 Kometa Wiki 的说明在设备上安装 Kometa

  2. 2

    创建包含 Plex 和 TMDb 的 URL 与凭据的配置文件

  3. 3

    为每个要处理的媒体库创建合集文件

  4. 4

    浏览 Kometa Wiki 了解更多功能

使用前须知

  • 需要 Plex 媒体服务器和 TMDb API 访问权限才能发挥作用。
  • 需要配置文件和合集文件，学习和设置需要一定投入。
  • develop 分支为测试版，可能存在缺陷。

收录于专题

家庭影音服务器

标签

#plex#metadata#media-library#automation#home-server#docker#kometa

常见问题

Kometa 是什么？
基于 Python 的脚本，用于更新 Plex 媒体库的元数据，并借助 TMDb、IMDb 等来源自动创建合集和播放列表。 Kometa 是一个面向 Plex 媒体服务器的 Python 脚本，可更新电影、剧集和音乐的封面、标题、简介等元数据，并基于 TMDb、IMDb 等来源自动创建合集和播放列表。
Kometa 可以免费使用吗？用的什么许可证？
Kometa 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
Kometa 还在维护吗？
活跃维护中。Kometa 最近一次提交是在 2026年11月6日。
Kometa 适合用来做什么？
将 Plex 媒体库整理为热门、类型、年代或制作公司等合集。 在媒体服务器数据库丢失后，保留并重新应用自定义封面和元数据。 为大型媒体库的海报统一添加状态或评分叠加标识。 通过连接 Sonarr 和 Radarr 实现媒体库的自动扩充。
Kometa 怎么安装和运行？
按照 Kometa Wiki 的说明在设备上安装 Kometa 创建包含 Plex 和 TMDb 的 URL 与凭据的配置文件 为每个要处理的媒体库创建合集文件 浏览 Kometa Wiki 了解更多功能
在哪里获取 Kometa？
源代码和安装说明在 GitHub 上：https://github.com/Kometa-Team/Kometa

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目