KikoPlay 脚本 TMDb & TVmazeList - 使用手册

脚本 TMDb+Lib (/library/tmdb.lua) 是用于弹幕视频播放软件 KikoPlay 的资料脚本，主要借助你从 The Movie Database (TMDB) 申请的API来搜索和刮削信息。也可设置选择刮削 fanart 的媒体图片、Jellyfin/Emby 的本地元数据、TVmaze的剧集演员。

脚本 TVmazeList (/bgm_calendar/tvmazelist.lua) 是针对剧集的日历时间表脚本（仅英国、美国等），主要借助从 TVmaze 的公共API刮削剧集的日历时间表(剧集标题为英文)。（测试中，不稳定，未来可能会有较大改动）

脚本 TraktList (/bgm_calendar/traktlist.lua) 是针对媒体的日历时间表脚本，主要借助从 TVmaze 的API刮削剧集/电影的日历时间表(标题为英文)。（测试中，不稳定，未来可能会有较大改动）

脚本~~仍在惰性地几乎~~没有编写中，希望大家多多发现Bug帮助完善脚本 : )

使用脚本TMDb+Lib，你可以得到：

使用脚本TVmazeList，你可以得到：

使用脚本TraktList，你可以得到：

目录

安装
使用
Q & A
TODO
本脚本基于…
- TMDb
- TVmaze
- fanart
- Trakt
- Jellyfin
- Emby
- KikoPlay
  - KikoPlay脚本仓库
反馈

安装

刮削来自TMDb+Lib的数据，你需要：

下载脚本文件。
- 下载library文件夹中的 tmdb.lua文件
- 复制到 KikoPlay 的资料脚本目录下即可
- 结果形如 .\KikoPlay\script\library\tmdb.lua。
（假设目录 .\KikoPlay为KikoPlay.exe 所在的文件夹）
从你的TMDb账户获取API密钥。
- 注册或登录你的 TMDb 账户后，
- 点击页面顶端右上方的头像弹出菜单里的 账户设置，点击设置中的API页面，申请和获取API密钥。
（具体方法见下：如何申请TMDb的API密钥？）
把你的API密钥填入脚本设置。
- 进入KikoPlay，点击左上图标 -> 点击设置脚本设置 -> 在TMDb+Lib一行右键 -> 点击设置，
- 填入你的API密钥。
（具体方法见下：如何设置脚本？）
你可以开始使用啦。

查看来自TVmazeList的剧集节目单，你需要：

下载脚本文件。
- 下载bgm_calendar文件夹中的 tvmazelist.lua文件
- 复制到 KikoPlay 的番组日历脚本目录下即可
- 结果形如 .\KikoPlay\script\bgm_calendar\tvmazelist.lua。
（假设目录 .\KikoPlay为KikoPlay.exe 所在的文件夹）
你可以开始使用啦。

查看来自TraktList的媒体节目单，你需要：

下载脚本文件。
- 下载bgm_calendar文件夹中的 traktlist.lua文件
- 复制到 KikoPlay 的番组日历脚本目录下即可
- 结果形如 .\KikoPlay\script\bgm_calendar\traktlist.lua。
（假设目录 .\KikoPlay为KikoPlay.exe 所在的文件夹）
从你的Trakt账户获取Client ID。
- 注册或登录你的 Trakt 账户后，
- 点击页面顶端右上方的头像弹出菜单里的把个人设置Settings中的 Your API Apps 申请到的Client ID 填入此项。
把你的Client ID密钥填入脚本设置。
- 进入KikoPlay，点击左上图标 -> 点击设置脚本设置 -> 在TraktList一行右键 -> 点击设置，
- 填入你的Client ID。
（具体方法见下：如何设置脚本？）
* 如果你设置 时间表 - 媒体范围 涵盖 my (Trakt账户里已关注的媒体)，而之前未设置账户授权，就会弹出账户授权向导。
你可以开始使用啦。

使用

脚本 TMDb+Lib 的用法

适用版本： TMDb+Lib >= 0.2.2.220428_alpha

刮削来自TMDb+Lib的数据，你可以：

把播放列表中的媒体文件关联到弹幕池时，使用 TMDb+Lib 搜索媒体的标题，选择你想要的并确认。
1. 打开播放标签页（首页），你在播放列表找到你要搜索的媒体文件，右键->关联->关联弹幕池。
2. 在弹出窗口的“搜索”下方的选项卡选择 TMDb+Lib，输入电影/剧集名称，就能看到搜索到的结果了。
3. 选中你需要的条目，会进入集数选择的页面，把你的媒体文件与集数信息对应，
4. 确认无误后点击右上的 √ 。
（具体方法见下：如何搜索媒体数据？）

电影会显示为一集，剧集为多集。输入剧集标题就好，默认设置部分支持形如"S01"、"第1季"等以空格与标题隔开的剧集季序号，不指定季序号默认第1季（，年份等搜索限制条件这里还不支持）。(￣▽￣)
依据媒体文件名，匹配刮削数据，以自动关联。把播放列表中未关联的媒体文件，自动关联到弹幕池。
- 选中播放列表的需要关联的文件名任一项或多项 -> 右键 -> 选中 TMDb+Lib。
（具体方法见下：如何匹配媒体文件？）
在资料库刮削媒体的详细信息、标签。
- 打开资料标签页，在资料库找到在你要刮削的媒体资料夹，右键 -> 更新，即可更新资料的详细信息。
- 对于多个，打开资料标签页，在资料库任意处右键 -> 批量操作。在弹出的对话框选取你要刮削的媒体，根据需要点击更新资料或更新标签。
（具体方法见下：如何获取资料夹详细信息？）
* 通过读取Jellyfin/Emby的元数据文件，匹配本地媒体文件。

如果你使用Jellyfin/Emby、并按照其规则组织媒体文件夹，那你可以发现在本地媒体文件同文件夹保存的.nfo媒体元数据文件（内含.xml格式文本），获取的详细信息就是来自这个文件。
- 需要更改脚本设置的匹配 - 数据来源为local_Emby_nfo。
- 从播放列表选中你的媒体文件（此时显示为文件名），右键 -> 选择关联 -> 选中最后一行的TMDb+Lib。

其他更多设置项见下：脚本 TMDb+Lib 的设置。

脚本 TVmazeList 的用法

适用版本： TVmazeList >= 0.1.20.220719_build

查看来自TVmaze的剧集节目单，你可以：

打开下载标签页，点击左侧侧边栏中番组日历的一项(日历形状的图标)，即可查看某一周的节目单(目前仅限GB、US、JP地区)。软件打开时日历时间表为本周。

未加载成功时，请约10~30秒后再刷新。
在右上方可以选择并查看某一周的节目单。

最后一行为本周；往过去出现几周、下一周是否显示及其位置都可以在脚本设置中设定。

（具体方法见下：如何查看某一周的节目单？）
放送站点一列，标记了该周播出的某季某集、播出平台及节目类型。显示的节目类型可以在脚本设置中设定。

右键某行的弹出菜单中，点击TVmaze或季序号集序号，弹出节目或某集的TVmaze页面；点击播放平台及节目类型，弹出媒体主页；点击字幕网站名，弹出搜索节目名称的页面。

其他更多设置项见下：脚本 TraktList 的设置。

脚本 TraktList 的用法

适用版本： TraktList >= 0.1.04.220801_fix

查看来自Trakt的剧集节目单，你可以：

打开下载标签页，点击左侧侧边栏中番组日历的一项(日历形状的图标)，即可查看按设置对应的分组时间段的节目单。软件打开时日历时间表为当前时间所在组。

未加载成功时，请约10~30秒后再刷新。
在右上方可以选择并查看某一组的节目单。

最后一行为当前时间所在组；往过去出现几组、下一组是否显示及其位置都可以在脚本设置中设定。

（具体方法与脚本TVmazeList 类似，见下：如何查看某一周的节目单？）
放送站点一列，标记了该周播出的某季某集、字幕站。显示的节目类型可以在脚本设置中设定。

右键某行的弹出菜单中，点击季序号集序号，弹出节目或某集的Trakt页面；点击Trakt，弹出媒体主页；点击字幕网站名，弹出搜索节目名称的页面。

其他更多设置项见下：脚本 TraktList 的设置。

Q & A

适用版本：TMDb+Lib >= 0.2.29.221005_build | TVmazeList >= 0.1.20.220719_build | TraktList >= 0.1.04.220801_fix

如何申请TMDb+Lib的API密钥?

打开 The Movie Database (TMDB) 首页，这是一个类似IMDb、豆瓣的媒体数据信息网站，涵盖电影、剧集、演员等。
点击页面顶端右侧的 EN 修改语言为 zh-CN，这样你就可以看到中文页面了。
你需要一个账户来登录。
- 没有账户则点击 注册，需要一个用户名、一个密码，以及用来验证的电子邮件。注册后，登录你刚刚使用的邮箱，查看TMDb发送的验证邮件，确认无误之后验证即可。然后打开登录页面登录。
+ 如果你已有账户点击右上的`登录`，需要用户名和密码；
登录后，点击在同样位置的你的头像，在弹出菜单点击账户设置。

点击默认语言 (default language)，输入/选择 zh-CN，界面就是简体中文的了。
点击左侧边栏的 API，在新的页面点击申请一个api。 本图图源自：@ 伪宅中的死宅
然后把 API 密钥 (v3 auth)下的一串字母数字复制下来，你就得到了你的TMDb的 API密钥。

在脚本设置界面的TMDb+Lib一行右键，点击检测连接，来检测网站及API(如果可能需要)是否能有效连接。显示成功连接 TMDb的API密钥，即为连接成功。
- 若无法连接到，那么你可能需要修改hosts文件，请搜索Windows 修改 hosts来了解相关教程。
  
  注意：hosts修改可能有安全风险，修改时请谨慎，确保安全。
  - 以下是一个添加hosts 已经过时的范例，建议你寻找网址/域名/DNS等的搜索网站搜索api.themoviedb.org、image.tmdb.org等域名。
```
# mediaDb Start
# TMDb
52.84.125.33 www.themoviedb.org
108.156.91.21 api.themoviedb.org
18.160.225.24 image.tmdb.org
# fanart
104.26.13.126 fanart.tv
91.134.1.171 webservice.fanart.tv
51.89.210.78 assets.fanart.tv
# trakt
172.67.3.215 trakt.tv
172.67.3.215 api.trakt.tv
# mediaDb End
```
  你可以尝试添加形式像这样的设置，到hosts中（例如其文件末尾）。（# XXXX 是注释，无功能，仅起提示作用）
  - 注意：已经修改过hosts了，如果一段时间后发生无法连接的情况，可能是因为服务器间隔几个月后有变更。此时需要重新搜寻合适的网址/域名/DNS，重新更改相关的hosts。

如何设置脚本?

点击 KikoPlay 左上图标 -> 点击设置；

点击脚本设置 -> 在 TMDb+Lib或TVmazeList等脚本一行右键 -> 点击设置；

* 脚本设置界面，在脚本一行右键。
- 可以通过检测连接来检测网站及API(如果可能需要)是否能有效连接。
- 可以通过使用方法弹出当前网页；
- 可以通过关于查看脚本相关信息；

如何设置脚本 TMDb+Lib

上一步操作TMDb+Lib后，在弹出窗口TMDb API 密钥那一行的<<API_Key_Here>> 处双击 -> 粘贴上面第7步得到的密钥。其他设置请根据你的需要选择。

其他更多设置项见下：脚本 TMDb+Lib 的设置、脚本 TVmaze 的设置

如何搜索媒体数据?

在播放列表搜索和刮削媒体

你在播放列表选一个媒体文件，右键->关联->关联弹幕池。

在弹出窗口的“搜索”下方的选项卡选 TMDb+Lib，输入电影/剧集名称，就能看到搜索到的结果了。

（输入标题就好，默认设置部分支持形如"S01"、"第1季"等以空格与标题隔开的剧集季序号（年份等搜索限制条件这里还不支持）。(￣▽￣)

选中你需要的条目，会进入集数选择的页面。在分集那一列的选中的一行，先双击、再单击，会弹出集数的列表，选中你需要的，把你的媒体文件与集数信息对应。确认无误后点击右上的 √ 。

（电影会显示为一集，剧集为多集。）

如何匹配媒体文件?

对于播放列表中未关联的媒体文件时：

选中播放列表的需要关联的文件名任一项或多项 -> 右键 -> 选中 TMDb+Lib。

对于拖拽媒体文件到播放列表时：

右键播放列表任一项 -> 开启自动关联模式 ，使其保持显示 √ 的状态。
右键播放列表任一项 -> 默认关联脚本 -> 选择 TMDb+Lib ，使其保持显示 √ 的状态。
现在拖拽媒体文件到播放列表中时会自动关联了。

如何获取资料夹详细信息?

打开资料标签页，在资料库找到在你要刮削的媒体资料夹，右键->更新。（也可以在资料库任意处右键 -> 添加动画，以添加新的媒体资料。）

*注：*资料库与弹幕池无关，请尽量不改动媒体标题。

*注：*更新后不会保留详细信息中编辑过的更改，会将其覆盖。
刮削完成后，点击媒体资料夹，你可以看到媒体的资料夹显示海报图片、剧情简介、演职员表、各种标签等。

如果标签等有格式不同，原因可能是此资料是在旧版本搜索、刮削的与当前不兼容，导致当前更新详细信息时有部分元数据无法识别。请启用搜索设置项 关键词作弹幕池标题 再搜索。

另外，在资料标签页，从资料库找到你要打开链接的媒体资料夹并右键，你可以看到有多种功能。

可以从你的浏览器弹出媒体对应的页面
- 媒体主页，IMDb、TMDb，fanart 的媒体页面；
- 豆瓣、贴吧、字幕网站搜索媒体标题的页面；
可以弹出对话框，显示媒体的图片、详细信息等元数据。

![image-Scraping.by.TMDb-7.2](manual.assets/image-Scraping.by.TMDb-7.2.1.png)

* 右键菜单部分功能目前仅限 Windows 系统。

如何查看某一周的节目单?

查看来自TVmaze的剧集节目单：（功能不全，暂定）

打开下载标签页，点击左侧侧边栏中番组日历的一项(日历形状的图标)，即可查看某一周的节目单(目前仅限GB、US、JP地区)。第一次打开时显示为本周。

未加载成功时，请约10~30秒后再刷新。

在右上方可以选择并查看某一周的节目单。
- 以周日为一周的第一天，以周日日期代表这一周，名称为形如YYYY-mm-dd的年月日。
- 第一次打开时默认为本周，即待选列表里的最后一行。待选列表依次为自定义某一周、此前几周、本周。往过去出现几周、下一周是否显示及其位置都可以在脚本设置中设定。
- 点击自定义星期，可以指定任意某天的日期来查看其所在周的节目单。第一次选择此项或点击刷新时，可以在弹出对话框输入形如YYYY-mm-dd的年月日，并确认√。
- 未加载成功时，请等待约10~30秒后刷新。更换日历为其他加载过的某一周时，会显示之前得到的该周节目单。更换日历为其他未加载过的某一周时，会自动加载；如未成功，请等待约10~30秒后刷新或操作。

分周列表中往过去显示几周，可以在脚本设置中设定，默认近10周。

其他

两个分支 (branches)

分支 KPS-k-pr： fork 自 KikoPlay脚本仓库，并用于 pull request。
分支 KPS-k-beta：用于展示 TMDb+Lib、TVmazeList、TraktList 这几个KikoPlay脚本的最新进展、使用方法等。

几个脚本均包含在内。

查看几个脚本的 [更新日志](CHANGELOG.md)

TODO

添加在TMDb/Trakt/TVmaze 标记为已看过/评分的功能；
添加推荐、相似的功能；
添加弹出播映视频的网站的功能；
添加时间表来自在Trakt/TVmaze的已关注剧集的功能；
...

本脚本基于…

TMDb

本脚本借助 TMDb 的 API 刮削信息。

The Movie Database (TMDB) is a community built movie and TV database.

Every piece of data has been added by our amazing community dating back to 2008. TMDb's strong international focus and breadth of data is largely unmatched and something we're incredibly proud of. Put simply, we live and breathe community and that's precisely what makes us different.

tmdb首页 - https://www.themoviedb.org/
个人设置 - https://www.themoviedb.org/settings/account
个人设置-申请 API - https://www.themoviedb.org/settings/api
API 开发用手册 - https://developers.themoviedb.org/3/getting-started/introduction

TVmaze

本脚本借助 TVmaze 的公共API 刮削剧集的日历时间表、演员表。

本节内容来自 TVmaze

Say hi to your new TVguide. Never miss a show again!

Find episode information for any show on any device. anytime, anywhere!

TVmaze 首页 - https://www.tvmaze.com/

fanart

本脚本借助 fanart 的 API 刮削媒体图片。

本节内容来自 fanart

Logos, Backgrounds, Posters and more for your TV, Movie and Music collections.

fanart 首页 - https://fanart.tv/
fanart 获取 API - https://fanart.tv/get-an-api-key/

Trakt

本脚本借助 Trakt 的 API 刮削和记录等。

本节内容来自 Trakt

Trakt is a platform that does many things, but primarily keeps track of TV shows and movies you watch. It integrates with your media center or home theater to enable scrobbling, so everything is automatic.

Trakt 首页 - https://trakt.tv
Trakt 的API页面 - https://trakt.tv/oauth/applications

Jellyfin

基于Jellyfin/Emby的本地匹配功能，是通过 Jellyfin/Emby 对本地媒体资料库的本地元数据缓存 .nfo文件内的 .xml 格式文本来匹配关联本地媒体文件的。

本节内容来自 Jellyfin

Jellyfin - The Free Software Media System

Jellyfin is the volunteer-built media solution that puts you in control of your media. Stream to any device from your own server, with no strings attached. Your media, your server, your way.

Jellyfin 首页 - https://jellyfin.org/

Emby

基于Emby的本地匹配功能，是通过 Emby 对本地媒体资料库的本地元数据缓存 .nfo文件内的 .xml 格式文本来匹配关联本地媒体文件的。

本节内容来自 Emby

Emby - Your personal media on any device

Bringing all of your home videos, music, and photos together into one place has never been easier. Your personal Emby Server automatically converts and streams your media on-the-fly to play on any device.

Emby 首页 - https://emby.media/

KikoPlay

本脚本是用于弹幕视频播放器 KikoPlay 的资料脚本。

KikoPlay - 不仅仅是全功能弹幕播放器

KikoPlay 首页 - https://kikoplay.fun
KikoPlay 的GitHub页面 - https://github.com/KikoPlayProject/KikoPlay

KikoPlay脚本仓库

本脚本的基本功能框架基于 KikoPlay 脚本仓库的脚本。

本节内容来自 /KikoPlayProject/KikoPlayScript

这里是 KikoPlay 的脚本仓库
KikoPlay支持Lua脚本，有三种类型：

弹幕脚本：位于script/danmu目录下，提供弹幕搜索、下载、发送弹幕等功能
资料脚本：位于script/library目录下，提供动画（或者其他类型的条目）搜索、详细信息获取、分集信息获取、标签获取、自动关联等功能
资源脚本：位于script/resource目录下，提供资源搜索功能

关于脚本开发的详细内容，请参考KikoPlay脚本开发参考

反馈

本节内容来自 /KikoPlayProject/KikoPlayScript

有新脚本可直接向 /KikoPlayProject/KikoPlayScript 提交PR。

如果有/KikoPlayProject/KikoPlayScript的相关问题，创建issue、或者到QQ群874761809反馈。

Name		Name	Last commit message	Last commit date
Latest commit History 75 Commits
bgm_calendar		bgm_calendar
library		library
manual.assets		manual.assets
resource		resource
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
reference.md		reference.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

KikoPlay 脚本 TMDb & TVmazeList - 使用手册

安装