# kodi_plugin

**Repository Path**: yyba-cn/kodi_plugin

## Basic Information

- **Project Name**: kodi_plugin
- **Description**: YYBA TMDB Kodi 刮削器
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-07
- **Last Updated**: 2026-08-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# YYBA TMDB Kodi 刮削器

Kodi 元数据刮削插件（电影 + 电视剧），by **yyba**。

📄 **完整产品说明见 [PRODUCT.md](PRODUCT.md)**（目录规范、缓存格式、配置、刮削流程）

## 插件一览

| 插件 | 说明 | 文档 |
|------|------|------|
| [metadata.yyba.movie](metadata.yyba.movie/) | 电影 · 本地优先 · `.movie/{title}.json` | [README](metadata.yyba.movie/README.md) |
| [metadata.yyba.tv](metadata.yyba.tv/) | 电视剧 · `.tv/{title}.json` + `.tv/{title}/SxxExx.json` | [README](metadata.yyba.tv/README.md) |

## 快速安装

```bash
cd metadata.yyba.movie && python build_zip.py   # → metadata.yyba.movie-install.zip
cd metadata.yyba.tv    && python build_zip.py   # → metadata.yyba.tv-install.zip
```

Kodi：**设置 → 插件 → 从 zip 安装**

## 特点摘要

- **本地优先** — 先读本地 JSON（`.movie/` / `.tv/`），命中不走 TMDB
- **元数据与视频分离** — 本地存储路径独立配置
- **TMDB 原始 JSON** — 不读写 NFO
- **域名可选** — api.tmdb.org / themoviedb.org / 手动 IP + Host

## 电视剧目录示例

```
美剧/黑镜/Season 1/S01E01.mp4     ← 视频
mata/.movie/蜘蛛侠.json             ← 电影缓存
tvmeta/.tv/黑镜.json                ← 整剧缓存
tvmeta/.tv/黑镜/S01E01.json         ← 单集缓存
```

## License

[Apache-2.0](LICENSE) · 使用 TMDB API，未经 TMDB 认可或认证。