图片
海报、背景图、标志和横幅有好几个来源。这一页说明图片从哪里来、怎样加入 fanart.tv 的图片、怎样优先选某种语言的图，以及怎样手动更换图片。
图片从哪里来#
服务器扫描条目时，会按下面的顺序找图，找到就用：
- 你自己放的图片。 媒体文件夹里的海报、背景图文件，以及 NFO 文件里指定的图片。
- 元数据插件。 TMDB 插件提供海报、背景图和演员照片。
- 图片来源插件。 fanart.tv 插件另外提供标志、背景、光盘图和横幅，通常比 TMDB 的更精致。
没有自己图片的单集，会显示这一季的图片，其次是剧集的缩略图，再其次是剧集海报。
使用 fanart.tv 的图片 FREE#
- 到 fanart.tv 注册并申请个人密钥（免费）。
- 在管理后台打开「插件」，进入 fanart.tv 插件，把密钥粘贴到它的设置里，然后启用。
- 打开「媒体库」，选择媒体库，在「图片来源」里加入 fanart.tv。
- 之后新扫描或刷新的条目会一并取得这些图片。已经在库里的条目，刷新它们的元数据即可。
fanart.tv 没有“季”的图片，季海报仍由其他来源提供。
优先选某种语言的图片 PRO · MAX#
同一部作品通常有好几种语言的海报。「海报语言优先」插件决定先选哪一种。它只重新排列数据来源给的图，不会多下载图片，也不会删除图片。
- 打开「插件」，进入「海报语言优先」。
- 在「优先使用」里选一项：
- 作品的原始语言（默认）：先用原始语言的图，其次是媒体库的语言，再其次是没有文字的图。
- 媒体库的元数据语言：先用媒体库的语言，其次是没有文字的图，再其次是原始语言的图。
- 保存并启用插件。之后扫描或刷新的条目会套用。
已保存图片的数量上限#
一部影片只有一张背景图，来源给出的其他横版图会保存为剧照，数量可能有几百张。两个设置用来控制服务器保存多少。打开「系统设置 → 设置 → 元数据」：
- 「每部影片最多保存的剧照」：默认 30 张，可设 1–200。
- 「每位演员最多保存的写真」：默认 30 张，可设 1–200。
保存新上限不会启动任何任务，下次刷新元数据时才生效：超出上限的来源图片会被删掉。你自己添加的图片和媒体文件夹里的图片文件不会被删。
手动更换图片#
打开条目，使用「图片」面板。每个位置（海报、缩略图、标志、背景图、横幅、艺术图、光盘图）都有「上传」或「更换」，以及「清除」。下面的「剧照」列出其余的图片。你可以添加或删除剧照，也可以在某张剧照上点「设成背景图」：原来的背景图会变成剧照，不会丢。
- 接受的文件：jpeg、png、webp 或 gif，最大 20 MiB。
- 上传的图片存在服务器的数据目录，不放在你的媒体文件夹里。
- 媒体文件夹里之后出现的较新的本地图片文件，仍可替换上传的图片。
- 「清除」只会从服务器移除这张图。媒体文件夹里的图片文件不会被删除，下次扫描会回来，之后的刮削也可能再补上。
手动裁切图片#
有些来源给的图片形状不对，例如一张横版封面，正面却在右半边。在条目或演员的「图片」面板里，图片旁边点调整裁切：
- 整张图上有一个固定比例的框：海报 2:3，演员照片 1:1，背景图和剧照 16:9。拖动图片移动位置，用滑杆（或双指）缩放。旁边有预览，演员照片以圆形预览。
- 快捷按钮：封面右半、居中、恢复插件建议（清除你的手动裁切，回到插件建议的样子）和恢复原图（用整张图，不裁切）。
- 点保存裁切。手动裁切过的图片会标示已手动裁切，之后插件再写同一张图时不会覆盖你的裁切。
- 原图一直保留，App 和第三方播放器取到的是裁切后的版本。
通过代理下载图片#
服务器连不上插件指定的图片主机时（例如那个主机在你所在的地区被挡），打开「系统设置 → 设置」，在「高级设置 → 图片下载代理」里填代理地址（http、https 或 socks5），还可以填它适用的主机，一行一个：主机名、*.example.com、IP 地址或 CIDR。留空表示所有插件图片。这只影响插件返回的图片。地址不改的话，已保存的凭据会保留。
图片尺寸与缓存#
服务器会按播放设备的屏幕大小提供合适尺寸的图片，并缓存起来，所以第二次打开会快很多。
条目刮削时，提供者给的海报、背景图、标志、缩略图和横幅会下载到服务器的数据目录，不再依赖来源一直能访问。下载失败时服务器先记下地址，下次刷新再试。剧照和演员写真只在有人查看时才去获取。使用 Emby 或 Jellyfin 模式的播放器每部影片只看到一张背景图，看不到剧照。