IwaraDownloadTool元数据同步实战如何把Iwara视频批量导入MediaCenter媒体库【免费下载链接】IwaraDownloadToolIwara 下载工具 | Iwara Downloader项目地址: https://gitcode.com/gh_mirrors/iw/IwaraDownloadToolIwaraDownloadTool是一款基于 Tampermonkey 的 Iwara 视频批量下载工具除了批量下载之外它还内置了MediaCenter 元数据同步能力把浏览器缓存的视频信息标题、简介、标签、作者、时长等一键或自动推送到 MediaCenter 媒体库实现Iwara 视频批量导入媒体库的全自动化归档流程。一、为什么需要元数据同步下载视频只是第一步真正让人头疼的是整理几百个视频散落在文件夹里没有标题、没有标签、没有作者信息MediaCenter 等媒体库也无法正确索引。IwaraDownloadTool 的同步功能解决了这个问题元数据自动填充标题、简介、标签、作者、时长、上传时间自动写入媒体库fileHash 去重以 Iwara 视频 ID 作为唯一标识重复推送不会产生重复记录️已下载标记配置 MediaCenter 后视频卡片上会自动显示已下载角标src/ui/ui.ts⚡两种触发方式下载完成自动推送 / 手动一键批量同步二、准备工作安装脚本与 MediaCenter1. 安装 IwaraDownloadTool在 Chrome / Edge≥110或 Firefox≥110中安装脚本管理器插件推荐 Tampermonkey从 GreasyFork 或 Release 页面安装IwaraDownloadTool.user.js首次打开 Iwara 会弹出引导点击确定后打开配置面板2. 部署 MediaCenter在你的电脑上部署一个 MediaCenter 服务本地或局域网均可记录两个关键信息信息示例API 地址http://127.0.0.1:3000API 密钥部署时生成的 Bearer Token三、最快配置方法MediaCenter API 设置打开插件菜单 →设置→MediaCenter标签页填入两项配置MediaCenter API服务地址默认为http://127.0.0.1:3000MediaCenter API 密钥你的 Bearer Token对应的默认配置定义在 src/core/config.tsmediaCenterApi: http://127.0.0.1:3000, mediaCenterApiKey: 小贴士API 密钥留空时所有同步功能会静默关闭。这也是安全设计——不配置就不发起任何请求。四、两种同步方式实战方式一下载完成自动推送推荐将下载模式切换为Aria2并开启实验性功能后Aria2 任务追踪器会接管每个下载任务任务进入队列后自动轮询下载状态速度过慢64 KiB/s自动重启任务错误任务自动重建下载完成的瞬间自动推送元数据到 MediaCenter推送核心逻辑在 src/download/aria2TrackManager.ts 的pushToMediaCenter中采用两步 API 调用createMediaPOST用 Iwara 视频 ID 作为fileHash创建媒体记录天然去重若返回 409 冲突则自动复用已有记录updateMediaPUT写入完整元数据标题、简介、标签、作者、时长、上传时间等方式二手动批量同步缓存元数据如果视频不是用 Aria2 下载的或想补推历史缓存可以手动触发全量同步入口函数是 src/network/mediaCenter.ts 中的syncCachedToMediaCenter它会分两个阶段执行阶段一建立 ID 映射从 MediaCenter 拉取全部视频列表/api/media优先用fileHash精确匹配 Iwara 视频 IDO(1) 命中未命中的再用标题 token 匹配兜底匹配结果批量写入本地idmap表src/core/db.ts下次同步直接走缓存速度更快阶段二并发更新元数据遍历所有匹配项6 并发逐个解析完整视频信息并调用updateMedia推送。进度会实时显示为更新 / 跳过 / 错误三项统计完成后弹出汇总提示例如MediaCenter 同步完成已更新: 128, 跳过: 3, 错误: 0五、常见问题排查现象原因与解决提示请先配置 MediaCenter API 地址和密钥设置面板的 MediaCenter 页中填写 API 地址和密钥提示没有找到缓存的视频数据浏览器 IndexedDB 中还没有视频记录先浏览/下载几个视频再同步提示未找到包含 fileHash 的视频记录MediaCenter 里还没有导入过任何视频可先用 Aria2 模式下载一个触发自动推送列表拉取失败检查 MediaCenter 服务是否启动、地址/密钥是否正确、浏览器能否直接访问该地址同步速度慢属正常现象阶段一会遍历本地全部缓存视频映射建立后第二次同步会明显加快六、相关源码文件一览文件职责src/network/mediaCenter.ts手动批量同步入口两阶段流程src/download/aria2TrackManager.tsAria2 任务追踪与pushToMediaCenter推送实现src/core/config.tsAPI 地址/密钥等配置项定义src/core/db.ts本地 IndexedDB 缓存与 idmap 映射表src/ui/ui.ts视频卡片已下载角标渲染七、总结用 IwaraDownloadTool 完成Iwara 视频批量导入 MediaCenter 媒体库只需三步填好 API 地址与密钥 → 选择 Aria2 下载模式或手动批量同步→ 等待元数据自动归档。整个过程无需手写任何脚本去重、重试、进度提示全部内置是 Iwara 用户搭建个人媒体库最省心的方案。【免费下载链接】IwaraDownloadToolIwara 下载工具 | Iwara Downloader项目地址: https://gitcode.com/gh_mirrors/iw/IwaraDownloadTool创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考