☰

Emby Cover Art Helper

Emby 封面查看&下载助手：在详情页与操作菜单添加查看/下载封面按钮，自动识别语言，性能优化、防重复注入。

作者
kumu-ze
日安装量
0
总安装量
0
评分
0 0 0
版本
1.0.1
创建于
2025-08-11
更新于
2025-08-11
大小
10.5 KB
许可证
MIT
适用于

Emby 封面下载 & 查看助手 (Emby Cover Art Helper)


自动在 Emby 媒体详情页与操作菜单(Action Sheet)中添加 “查看封面” 与 “下载封面” 按钮，支持自动识别语言、避免重复注入、性能优化。

✨ 特性

  • 一键查看原图（新标签打开）
  • 一键下载封面图（智能文件名 / 自动扩展名）
  • MutationObserver + 去抖，减少性能消耗
  • 防重复注入（路由内跳转稳定）
  • 自动多语言（当前支持：中文/English）
  • 优先使用 GM_download，失败回退 Blob 下载
  • 响应头识别图片类型（jpg/png/webp 等）
  • 结构模块化，方便扩展更多操作（复制直链、替换封面等）

🚀 快速安装

  1. 安装 Tampermonkey 扩展。
  2. 点击：➡️ 直接安装/更新脚本
  3. 进入你的 Emby：http(s)://你的地址/web/index.html
  4. 打开任意媒体详情页确认按钮出现。

若未弹出安装框：确保扩展已启用，清空缓存后再试。

🛠 配置 (脚本内 CONFIG)

键说明默认
debounceMsDOM 变动去抖间隔 (毫秒)120
enableActionSheet是否在操作菜单注入按钮true
enableDetailButtons是否在详情页注入按钮true
preferGMDownload优先使用 GM_downloadtrue
openInNewTab查看封面是否新标签页打开true

📘 使用说明

  • 进入任意影片 / 剧集详情页：按钮会出现在原生按钮区域。
  • 在条目触发“更多操作”弹出的 Action Sheet，也会出现两项（查看 / 下载）。
  • 下载文件名：优先使用条目标题 → 过滤非法字符 → 附加真实扩展名。

🔐 权限说明 (@grant)

  • GM_addStyle：注入少量额外样式。
  • GM_xmlhttpRequest：获取封面二进制数据并兼容跨域。
  • GM_download：更优雅的下载（有则用，失败回退）。

不收集、不传输任何用户隐私数据。

❓ FAQ


按钮不出现？
  • 确认当前是媒体详情页或 Action Sheet 已展开。
  • 检查是否有其它脚本修改了 Emby DOM。
  • 打开控制台搜索 [CoverHelper] 调试日志。


下载的扩展名不正确？

服务器未返回 Content-Type 时会回退为 .jpg，可手动重命名或自行改进逻辑。



想自托管/加速？

把脚本放到你自己的静态站点，并同步修改头部 @downloadURL / @updateURL。



🗂 更新日志

  • v1.0：初始公开版本，含查看/下载、去抖、i18n、类型识别、Action Sheet 支持。

🧪 兼容性

  • Emby Web 前端（标准路径 /web/index.html）
  • Chrome / Edge / Firefox (现代 Chromium/Gecko)
  • 移动端浏览器若支持 Tampermonkey 基本亦可（UI 紧凑时按钮可能换行）

🔒 隐私与安全

  • 不进行网络上报 / 日志上传。
  • 只在 Emby 前端页面内运行。
  • 不注入第三方远程脚本。

🛣 路线图 (Roadmap)

  • 复制封面直链按钮
  • 可切换不同封面类型（海报 / 背景图）
  • 快捷重载封面缓存
  • 可选自动命名模版（含年份 / 清晰度）

📄 许可证

MIT License —— 可自由修改与再分发，请保留版权说明。

🔍 关键词 (SEO)

Emby, Poster, Cover, 封面, 下载, Download, 脚本, Userscript, Tampermonkey, 海报下载, 详情页, Action Sheet


English (Brief)

A lightweight userscript adding “View Cover” & “Download Cover” buttons to Emby detail pages and the action sheet. Debounced DOM observer, i18n (ZH/EN), MIME-based extension detection, safe filenames, and GM_download fallback logic included.