在使用 Emby 管理媒体库时，我们经常会被高质量的电影海报或番剧封面吸引。但遗憾的是，Emby 的原生界面并没有提供便捷的“查看原图”或“下载封面”的入口。

为了解决这个痛点，我写了一个轻量级的用户脚本 —— Emby Cover Art Helper。

它能无缝集成到 Emby 的详情页和右键菜单中，让你轻松获取高质量的媒体封面。

Github 项目地址：kumu-ze/Emby-Cover-Art-Helper

✨ 主要功能

Emby Cover Art Helper 是一个 Tampermonkey/Greasemonkey 用户脚本，安装后会自动在 Emby 界面注入以下功能：

1. 👁️ 查看封面：点击后在新标签页打开未压缩的高清原图。
2. ⬇️ 下载封面：一键下载图片到本地，脚本会自动识别文件名和后缀（优先使用 GM_download API，兼容性更好）。

特性亮点

• 性能优化：使用去抖动（Debounce）的 MutationObserver，确保在页面频繁切换时也不会卡顿。
• 智能兼容：自动根据浏览器语言显示中文或英文界面。
• 无感集成：按钮样式与 Emby 原生 UI 保持一致，毫无违和感。
• 双模式运行：既支持通过油猴插件运行，也支持服务端直接注入（无油猴环境也能用）。

📥 安装方式

方式一：一键安装（推荐）

如果你已经安装了 Tampermonkey (油猴) 扩展，直接点击下方链接即可安装或更新：

➡️ 点击前往 GreasyFork 安装

方式二：手动安装

如果你无法访问 GreasyFork，可以使用 GitHub 的 Raw 链接安装：
点击这里安装 (GitHub Raw)

🚀 进阶玩法：服务端部署（免插件）

如果你是 Emby 服务器的管理员，希望让你的所有用户（包括不懂技术的小白）都能直接拥有这个功能，而不需要他们安装油猴插件，可以使用 “客户端直接引入模式”。

操作步骤：

1. 下载 Emby-Cover-Art-Helper.js 文件。
2. 将文件放置在 Emby 服务器可访问的静态目录中（例如反向代理的 /branding/ 目录）。
3. 修改 Emby 的 index.html 模板，在 </body> 前加入：

4. 清理浏览器缓存刷新即可。

脚本内置了降级处理，在没有油猴 API 的环境下，它会自动使用原生 fetch + Blob 方案进行下载，功能完全一致。

⚙️ 配置说明

脚本代码顶部提供了一个 CONFIG 对象，你可以根据喜好修改：

💬 常见问题

• Q: 按钮没出现？
  • A: 请尝试强制刷新页面 (Ctrl+F5)。如果仍未出现，请检查浏览器控制台是否有 [CoverHelper] 开头的日志。
• Q: 下载的文件没有后缀？
  • A: 脚本会自动尝试从服务器响应头推断后缀。如果服务器未返回正确的 Content-Type，默认会保存为 .jpg。

如果你觉得这个脚本好用，欢迎在 GitHub 给个 Star ⭐️！

👉 项目地址： https://github.com/kumu-ze/Emby-Cover-Art-Helper