peach

peach-mitaoAGPL-3.0活跃维护

本地优先的视频元数据刮削与媒体库管理工具,自动整理影片信息并支持自托管播放,适合搭建个人影音库。

Peach: Local-first video metadata scraper and media manager.

v0.57.0发布于 2026-11-09 00:36 UTC14,845star +164 / 7 天1,715fork同步于 2026-11-10 23:28 UTC

怎么上手

由 README 提炼,执行前请确认
从 Releases 下载对应安装包,如 Peach-0.56.0-windows-x64-setup.exe;源码运行需 Git、uv 和 Python 3.14+,详见 docs/OPERATIONS.md
硬件要求按 README 说明

README 未说明具体显存或 GPU 型号要求;提供 Windows x64、macOS(Apple Silicon 与 Intel)安装包,以及 Docker/NAS 部署方式。

支持 Apple Silicon
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

本地优先的视频元数据刮削与媒体库管理工具,统一整理本地和云端影片

本地优先的视频元数据刮削与媒体库管理工具,自动整理影片信息并支持自托管播放,适合搭建个人影音库。

核心能力

  • 识别番号并读取 NFO,从多源补全标题、演员、片商和封面
  • 同时浏览本地磁盘、SMB、挂载云存储和 PikPak 库
  • 支持网页与外部播放器、字幕、倍速、续播和时间轴预览
  • 按番号搜索或提交磁力链下载,完成后自动归档入库
  • 管理标签、重复项、版本与分段,元数据和观看历史存本地

容易踩的坑

桌面测试包未签名,macOS 包未公证,首次打开可能被系统拦截;源码运行要求 Python 3.14+,版本不够会装不上;Docker/NAS 部署需按 docs/DOCKER.md 单独配置。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.57.0
  1. v0.57.0pre-release最新正式版2026-11-09 · 2026-11-09 00:36 UTC

    新增

    • 配置:新增容量保护,可给数据和缓存设上限,超限时先清最旧的播放缓存、暂停后台任务,不挡播放。
    • 配置:设置里新增「修复与迁移」,列出升级后各项修复的进度、等你确认的项和历史记录。
    • 更新:升级后弹出这一版的更新说明,只列和这台机器有关的条目,检查更新里可以再次打开。
    • 界面:侧栏和管理菜单可以拖动排序,每个分组都能恢复默认顺序。
    • 馆藏:扫描与采集可以只选一个媒体库。
    • 采集:JAV 新作页可以多选,批量加入想要或查找资源。
    • 界面:后台任务统一用三档速度调节,活动历史、云下载、新作、想要与复核列表都有完整分页栏。
    • 采集:云下载添加任务遇到暂时性错误时自动有限重试,结束后显示准确的结果。
    • 界面:作品卡没有图时写明缺的是什么、为什么缺,可当场抓取封面、补全这一部的预览或重试。
    • 界面:刚入库的女优、厂牌页与作品详情在资料补全期间显示「正在补全」,补完自动刷新头像与资料,不用刷新页面。
    • 界面:界面语言默认跟随浏览器与系统语言,英文环境下侧栏和管理菜单先显示英文,其余页面逐步补齐;可在「外观与导航」里固定。
    • 界面:英文界面下,数据管理、垃圾文件、重复文件与媒体修复几页换成英文。
    • 配置:Docker Compose 部署可以用环境变量调整健康检查间隔和容器日志轮转,容器日志默认单个 10 MB、保留 3 份(#502)。

    变更

    • 播放:网盘里的视频不随升级批量补测显示尺寸,改在「修复与迁移」确认后才开始,系统盘不足时整批暂停(#452)。
    • 馆藏:补全预览不再只限本地,免费网盘目录一起抽帧;开了流量保护的目录点名补全时先确认。
    • 界面:数据管理几页的说明和确认框改短,只留做决定需要的范围、能否恢复和保留什么。
    • 配置:「上传馆藏与口味明细」增加容量与播放活跃的汇总,之前开启过的要在「数据上传」里重新同意。
    • 界面:去掉名字下方「暂无已核对的中文写法」、无时长原因、统计页抬头等解释内部机制的提示文字。

    修复

    • 播放:横竖屏改按显示宽高比(SAR)判定,非方形像素的横屏片不再被当成竖屏,旧视频升级后自动补测(#433)。
    • 馆藏:群晖 @eaDir、飞牛元数据和 macOS ._ 等系统附属文件不再入库,已入库的升级后自动移进回收站(#432)。
    • 馆藏:扫描跳过外接盘根目录下 macOS 的 .DocumentRevisions-V100 版本库,不再因读不了它报错。
    • 馆藏:文件只改了大小写时,扫描跟随磁盘上的实际写法,整理也能只改大小写,不再报文件不存在(#487)。
    • 复核:资产永久删除后留下的候选改挂到同一文件的新编号,对不上的撤下,不再报「没有匹配的可用资产」(#486)。
    • 复核:只剩未收录 genre 的标签候选点「通过」直接结案,不再报「标签候选为空」(#486)。
    • 馆藏:升级时解除早期采集乱码留下的人物关联,并重新补采演员。
    • 关注:后台同步来的新条目重新出现在关注页列表里(0.56.0 引入的问题)。
    • 播放:长片修复文件头时按解码进度判断是否卡住,不再固定 900 秒超时失败(#434)。
    • 采集:整趟采集预算用完后不再逐部空转几个小时,任务卡写明还剩几部没问、再跑一次接着采,问题清单只记一条(#513)。
    • 界面:人物页不再给出按名字对上的旧艺名空 JavDB 页,订阅新作也不再拉它,同一人的无码页照常保留;升级时按本机缓存判断,缓存里没有的保持原样。
    • 采集:JavDB、DMM、MGS 等站拒绝当前代理出口时,订阅与来源检查直接说明要换出口,不再报「解不出任何条目」。
    • 更新:检查更新连不上 GitHub 时改从下载镜像取版本,不再停在 0.50.0 或说当前版本比最新版还新(#454)。
    • 采集:JavDB 同一番号同时有 FANZA 限定版与通常版时,刮削认通常版,不再报身份不明(#431)。
    • 采集:FC2 作品的演员按身份核对,身份待确认的 JavDB 演员不再自动填入。
    • 采集:云下载完成后刷新网盘目录接着入库,不再停在未登记。
    • 馆藏:进程号被别的程序占用后,中断的扫描任务可以重新启动,不再被当成还在运行(#268)。
    • 关注:每个来源的原始快照只留最近 3 份和条目引用的,旧版积下的可在「修复与迁移」确认后删除。
    • 更新:后台任务结束后不再在数据目录留下状态文件,升级时自动清掉旧版积下的几万个。
    • 更新:影片补全做完后删掉自己的进度文件,升级时自动清掉旧版留下的上万个。
    • 更新:进程正常退出时删掉空的崩溃日志,升级时清掉旧版积下的空日志文件(#485)。
    • 更新:升级补修遇到网盘未挂载、站点冷却或容量超限时延后再派,失败的可在「修复与迁移」重试。
    • 馆藏:推送发现已收到、还在等文件写完的新文件,服务重启后接着登记,不再丢掉。
    • 关注:「全部标记已看」「全部忽略」超过 1000 条时不再漏标,改为每 1000 条一批提交。
    • 关注:来源的退避与冷却跨重启保留,重启后不再马上重试被限流的站点。
    • 采集:补女优资料、资料处理与视频预告同时访问 javdb 时共用一份间隔,合计不超过每分钟 20 页。
    • 播放:播放时送流不再和页面请求抢线程,播放心跳也不再让其他页面重新读取。
    • 播放:浏览图片墙、打开带字幕的视频时,命中本机缓存就不再访问网盘。
    • 界面:馆藏、复核、重复项与垃圾评分页在大馆藏里打开和翻页更快(#298)。
    • 界面:后台任务在跑时,首页、资料页与统计不再每两秒整组重新读取,至多半分钟刷新一次。
    • 界面:JAV 发现页与新作页读取作品资料时不再每 3 秒整页重算。
    • 界面:点开搜索框不再发十几次统计请求;任务中心展开上千项的任务只列在跑的与最近 50 项。
    • 配置:网盘卡住时设置页不再一直停在加载,媒体目录的在线状态改读后台检测结果。
    • 更新:升级后安排补资料期间,每分钟的后台检查不再整包重读种子包、逐位查女优和读头像。
    • 账本:迁移、删除与账本恢复中途出错时整步回滚,不再留下对不上的引用。
    • 配置:首次设置里 HTTPS 证书签发失败时可以重试,不再卡在半完成状态。
    • 界面:入库通知点开直接进作品详情,详情标签页显示番号和文件名。
    • 界面:按 ID 打开的资料页标签页标题显示人名,回收站、JAV、竖屏与搜索结果也有各自的标题。
    • 界面:视频预览加载失败时在原画框里显示可重试的提示,不再撑乱布局。
    • 界面:按 Esc 关掉弹层时不再顺带收起侧栏,分区页加载时不再跳动。
    • 采集:社交平台头像改读本人资料页,换头像后作品与新作卡片同步更新。
    • 播放:本机代理用 Fake-IP 时,JavDB 预告片也能正常播放。
    • 关注:Iwara 来源图标在浅色主题下看得见。
    • 界面:浅色主题下作品卡左上角的本地、在线来源图标不再淡得看不见。

    Full Changelog / 完整变更

    Windows 安装包、免安装包和 macOS DMG 都内置 Python、FFmpeg、untrunc、cloudflared 和人脸模型,装好即可使用;Docker 镜像适合 NAS 与 Linux 服务器。安装与使用见 Windows 使用说明、macOS 使用说明和 Docker 部署。

    下载选择

    平台下载说明
    Windows x64安装包首次安装推荐
    Windows x64轻量安装包不含工具,复用已装的或安装时联网下载
    Windows x64[免安装包(ZIP)](https://github.com/peach-mitao/peach/releases/downl
  2. v0.56.0pre-release2026-11-05 · 2026-11-05 14:31 UTC
    查看更新说明

    新增

    • 更新:Docker 镜像同时发布到 ghcr.io/peach-mitao/peach,Docker Hub 拉取受限时可以改用。
    • 配置:全新 Docker 首次打开走与桌面相同的首次设置,可设密码或免登录,不再要口令。

    修复

    • 馆藏:转存、极短或尾部损坏的视频,九宫格靠后几格解不出时改取更早的画面,不再一直挂在「需要处理」(#392)。
    • 采集:JavDB 匿名接口的一个主机连不上时自动换下一个,三个都不通才暂停刮削(#315)。
    • 复核:番号改回短号的影片(如 MCDV-24)复核页不再摆出按旧番号取到的资料,升级时撤下并按现番号重采,已批准的字段不动(#296)。
    • 馆藏:入库、采集和 JAV 新作、发现页认女优与厂牌更快。
    • 界面:后台任务写入资料时和重启后,目录、索引与统计页打开不再等重算。
    • 界面:任务中心打开从约 1.7 秒缩短到约 0.1 秒。
    • 界面:后台任务运行时,打开页面不再每次都重新计算搜索推荐。
    • 关注:新作列表不再显示「NOW PRINTING」占位图,还没出封面的未发售新作等官方出图后再列出。

    Full Changelog / 完整变更

    Windows 安装包、免安装包和 macOS DMG 都内置 Python、FFmpeg、untrunc、cloudflared 和人脸模型,装好即可使用;Docker 镜像适合 NAS 与 Linux 服务器。安装与使用见 Windows 使用说明、macOS 使用说明和 Docker 部署。

    下载选择

    平台下载说明
    Windows x64安装包首次安装推荐
    Windows x64轻量安装包不含工具,复用已装的或安装时联网下载
    Windows x64免安装包(ZIP)解压后运行 Peach.exe
    macOS Apple SiliconDMGM 系列芯片
    macOS IntelDMGIntel 处理器
    Docker / NASlongmeidao/peach:0.56.0ghcr.io/peach-mitao/peach:0.56.0同一镜像,Docker Hub 拉取受限时用 ghcr.io

    其余文件不用手动下载:update.zip 和 FFmpeg、untrunc、cloudflared、人脸模型 工具包由 Windows 更新器按需取用;*-corresponding-source.zip 是第三方工具的对应源码;SHA256SUMS.txt 用来核对文件。

    更新已有安装

    平台方法
    Windows「配置 → 应用与维护」检查更新,下载完成后确认重启;也可以直接运行新安装包
    macOS菜单栏「版本与更新」>「检查更新」;0.53.0 及更早版本先手动装一次新 DMG
    Docker拉取新镜像后重建容器,启用 Watchtower 时可在配置页一键更新,见 Docker 部署

    macOS 首次安装

    不确定选哪个 DMG,在「关于本机」看芯片:Apple M 系列选 Apple Silicon,Intel 处理器选 Intel。打开 DMG,把 Peach 拖进「应用程序」,再打开应用完成首次设置。

    安装包使用 ad-hoc 签名,还没有完成 Apple 公证。提示「已损坏,无法打开」时,在终端执行 sudo /usr/bin/xattr -rd com.apple.quarantine "/Applications/Peach.app" 后重新打开;要求输入的是这台 Mac 的登录密码,输入时屏幕不显示字符。这条命令只移除 Peach 的隔离标记。手动拖入新版本后要再执行一次,经应用内更新安装的不需要。

    系统版本下限以包内 LSMinimumSystemVersion 为准。来源挂载与双机复制见 macOS 使用说明。

    Docker

    edge 标签始终指向最新一版,要固定版本就用上表里带版本号的标签。部署、更新与回滚见 Docker 部署。

  3. v0.55.1pre-release2026-11-05 · 2026-11-05 07:39 UTC
    查看更新说明

    修复

    • 界面:后台任务成批写入后,统计、作品列表、索引、JAV 新作和搜索推荐首次打开更快。
    • 更新:装了 0.54.0、0.55.0 的 Mac 独立包,在应用内检查更新能收到新版了。

    Full Changelog / 完整变更

    Windows 安装包、免安装包和 macOS DMG 都内置 Python、FFmpeg、untrunc、cloudflared 和人脸模型,装好即可使用;Docker 镜像适合 NAS 与 Linux 服务器。安装与使用见 Windows 使用说明、macOS 使用说明和 Docker 部署。

    下载选择

    平台下载说明
    Windows x64安装包首次安装推荐
    Windows x64轻量安装包不含工具,复用已装的或安装时联网下载
    Windows x64免安装包(ZIP)解压后运行 Peach.exe
    macOS Apple SiliconDMGM 系列芯片
    macOS IntelDMGIntel 处理器
    Docker / NASlongmeidao/peach:0.55.1ghcr.io/peach-mitao/peach:0.55.1同一镜像,Docker Hub 拉取受限时用 ghcr.io

    其余文件不用手动下载:update.zip 和 FFmpeg、untrunc、cloudflared、人脸模型 工具包由 Windows 更新器按需取用;*-corresponding-source.zip 是第三方工具的对应源码;SHA256SUMS.txt 用来核对文件。

    更新已有安装

    平台方法
    Windows「配置 → 应用与维护」检查更新,下载完成后确认重启;也可以直接运行新安装包
    macOS菜单栏「版本与更新」>「检查更新」;0.53.0 及更早版本先手动装一次新 DMG
    Docker拉取新镜像后重建容器,启用 Watchtower 时可在配置页一键更新,见 Docker 部署

    macOS 首次安装

    不确定选哪个 DMG,在「关于本机」看芯片:Apple M 系列选 Apple Silicon,Intel 处理器选 Intel。打开 DMG,把 Peach 拖进「应用程序」,再打开应用完成首次设置。

    安装包使用 ad-hoc 签名,还没有完成 Apple 公证。提示「已损坏,无法打开」时,在终端执行 sudo /usr/bin/xattr -rd com.apple.quarantine "/Applications/Peach.app" 后重新打开;要求输入的是这台 Mac 的登录密码,输入时屏幕不显示字符。这条命令只移除 Peach 的隔离标记。手动拖入新版本后要再执行一次,经应用内更新安装的不需要。

    系统版本下限以包内 LSMinimumSystemVersion 为准。来源挂载与双机复制见 macOS 使用说明。

    Docker

    edge 标签始终指向最新一版,要固定版本就用上表里带版本号的标签。部署、更新与回滚见 Docker 部署。

  4. v0.55.0pre-release2026-11-05 · 2026-11-05 04:46 UTC
    查看更新说明

    新增

    • 界面:作品入库后,打开着的页面弹出通知,点「打开」直达这部作品。
    • 更新:Docker 部署可在配置页一键更新,需先启用可选的 Watchtower,见 Docker 部署。
    • 采集:影片详情可「重新抓取资料」,逐字段选用并保护;资料来源顺序可按影片类型调整(#139)。
    • 关注:JAV 订阅增加 DMM / FANZA 片单;用户脚本可在 JavDB、DMM、MISSAV 的女优页直接订阅。
    • 采集:素人片缺演员时查素人系総合 Wiki 补上艺名;minnano-av 没收录的女优从 avbase 补资料。
    • 采集:「来源和凭证」可一键检查各资料源与图片 CDN 能否连上,命令行用 peach check-sources(#382)。
    • 配置:「网络与访问」可更换访问口令、分发 HTTPS 证书、逐台撤销已登录设备;源码运行可一键装 FFmpeg。
    • 账本:「应用与维护」可立即备份账本,或从任一份备份恢复。
    • 馆藏:无码版次分为无码、无码流出、无码破解三档;重复文件页可把一组标为「都保留」。
    • 界面:Shift+S 随时开关 SFW 模式;换页较慢时页面顶边显示进度条。

    变更

    • 采集:刮削和找资源的 JavDB 一环改用公开匿名接口,不再需要 Cookie,也不受 Cloudflare 影响(#315)。
    • 复核:只差写法或只有社区站异议的资料不再进复核;自动写入的资料可在复核页逐条撤回。
    • 播放:用 mpv、VLC、IINA 打开的作品也记下观看;小窗和沉浸模式的进度条可预览画面。
    • 关注:订阅源错开时间拉取,久未更新的来源逐级放慢检查,JavDB 冷却结束后自动重拉。
    • 采集:随附用户脚本更新至 0.7.4,任务结束后留在浮卡直到标为已读,并识别 DMM 素人与 FC2 商品页。

    修复

    • 界面:任务多时,统计页、新作页和各页首屏不再被拖慢几秒到十几秒;任务中心同类任务合成一张卡。
    • 更新:升级后的自动修复分批派发,不再一次排满整个媒体库,也不再把网盘影片全部重新处理。
    • 关注:只缺封面的新作写明原因、可优先取图;库外作品封面被删后能取回原来的高清图。
    • 采集:首次处理时断网,本地部分照常完成、联网后补齐;云下载停滞后继续复查,网盘无响应时自动重交。
    • 采集:HEYZO 小于 1000 的编号恢复识别(#354),r18.dev 封面恢复可用,找资源全被筛掉时说明原因。
    • 馆藏:清除从文件名误认出的番号;只出无码的厂牌直接按无码查询;网盘掉线时不再误报目录不存在。
    • 播放:进度条预览只显示指向时刻那一格,两端不再被裁掉,没有缩略图时只显示时间。
    • 界面:人物页入口不再指向旧艺名(#271),首页骨架只出一轮,Safari 输入法回车不再提前提交。
    • 桌面:诊断包记下每次重新拉起服务的原因和启动耗时,便于排查「服务未运行」。

    Full Changelog / 完整变更

    Windows 安装包、免安装包和 macOS DMG 都内置 Python、FFmpeg、untrunc、cloudflared 和人脸模型,装好即可使用;Docker 镜像适合 NAS 与 Linux 服务器。安装与使用见 Windows 使用说明、macOS 使用说明和 Docker 部署。

    下载选择

    平台下载说明
    Windows x64安装包首次安装推荐
    Windows x64轻量安装包不含工具,复用已装的或安装时联网下载
    Windows x64免安装包(ZIP)解压后运行 Peach.exe
    macOS Apple SiliconDMGM 系列芯片
    macOS IntelDMGIntel 处理器
    Docker / NASlongmeidao/peach:0.55.0NAS 与 Linux 服务器部署

    其余文件不用手动下载:update.zip 和 FFmpeg、untrunc、cloudflared、人脸模型 工具包由 Windows 更新器按需取用;*-corresponding-source.zip 是第三方工具的对应源码;SHA256SUMS.txt 用来核对文件。

    更新已有安装

    平台方法
    Windows「配置 → 应用与维护」检查更新,下载完成后确认重启;也可以直接运行新安装包
    macOS菜单栏「版本与更新」>「检查更新」;0.53.0 及更早版本先手动装一次新 DMG
    Docker拉取新镜像后重建容器,启用 Watchtower 时可在配置页一键更新,见 Docker 部署

    macOS 首次安装

    不确定选哪个 DMG,在「关于本机」看芯片:Apple M 系列选 Apple Silicon,Intel 处理器选 Intel。打开 DMG,把 Peach 拖进「应用程序」,再打开应用完成首次设置。

    安装包使用 ad-hoc 签名,还没有完成 Apple 公证。提示「已损坏,无法打开」时,在终端执行 sudo /usr/bin/xattr -rd com.apple.quarantine "/Applications/Peach.app" 后重新打开;要求输入的是这台 Mac 的登录密码,输入时屏幕不显示字符。这条命令只移除 Peach 的隔离标记。手动拖入新版本后要再执行一次,经应用内更新安装的不需要。

    系统版本下限以包内 LSMinimumSystemVersion 为准。来源挂载与双机复制见 macOS 使用说明。

    Docker

    edge 标签始终指向最新一版

  5. v0.54.0pre-release2026-11-03 · 2026-11-03 21:14 UTC
    查看更新说明

    新增

    • 关注:JAV 页新增「新作」分区,列出订阅到、还没入库的新作,可排序、筛选、切成列表;首页加「查看全部新作」。
    • 更新:macOS 独立包带上应用内更新,「检查更新」下载并核对新版本,确认后替换应用并重新打开。

    变更

    • 界面:作品列表的媒体库与艺人拆成单独两列,可隐藏、调宽,默认显示的列也有调整;JAV 页的筛选框移到页头标题行右侧。
    • 界面:空搜索框的推荐提前取好、每组可单独「换一批」,占位推荐词轮换;搜索结果页标题写出搜索词。
    • 界面:任务卡按类别加图标,后续任务改用「对象 + 动作」的名字,读数为 0 写「未使用」,视频修复卡列出正在修复的文件;各页卡片去掉外圈描边。
    • 界面:播放墙滚轮改为以指针为中心缩放,键盘 +/- 缩放、0 回到起点;工具面板拆成左上角两枚圆键。
    • 界面:「接着看」写出两部作品共有的少见标签,卡片统一;详情页标签超过 24 枚时先折叠,点「还有 N 个」展开。
    • 采集:随附用户脚本更新至 0.7.1,浮卡可「重试整理」、列出其他任务,多个来源页共享任务进度。
    • 采集:扫描与采集的问题提示合成一块,「7 天内不再问」、完整记录和导出都在同一个框里,归档可撤销。
    • 配置:「版本统计与错误诊断」大幅减少上传量;配置页的说明直接写在每一项设置下方。
    • 更新:更新应用、采集桥与界面的兼容依赖,保持现有来源接口、网页资料解析和文件锁行为。

    修复

    • 界面:右下角的任务卡、回执和失败提示排进同一个通知栈,不再叠在一处;失败的任务卡重新显示红色框线。
    • 馆藏:扫描 SMB 共享时整趟共用一条连接,明显加快;目录改名换编码后沿用原记录,不再多出重复条目。
    • 采集:封面来源只是部分连不上时不再记成「7 天内不再问」;云下载整理不再因一个资料站限流就整条失败。
    • 馆藏:扫描与采集的「停止任务」改为「取消任务」,任务未结束时点同步会说明原因,命令行扫描显示文件数。
    • 馆藏:云下载落地目录里的推广短视频、网址文本和二维码图片自动移入回收站,不再混进馆藏。
    • 界面:播放墙、首页和数据管理各页的加载骨架与页面一致;播放墙拖动更顺,窄屏重新进入不再整面黑屏。
    • 采集:随附用户脚本更新至 0.6.11,浮卡切换不再闪,不把评论署名当番号,素人作品的头像不再变成两个人。
    • 关注:删除作品或清空回收站后,新作与想要清单的封面不再被当成缓存删掉;作者头像取不到时改用归档站那张。
    • 桌面:本机代理或安全软件改写请求时,不再误报「请从 Peach 设置页提交」;Windows 上客户端提前断开后服务立即重新监听。
    • 馆藏:MCDV-24(无码)与 MCDV-024(有码)不再被当成同一部,资料和封面各取各的。
    • 界面:作品详情缺封面时可点「立即重试」;搜索后点侧栏「首页」能回到首页;发现页与诊断页的进度条放进框里。
    • 馆藏:移除媒体目录后资源同步能清掉失效记录;读取新入库范围不再撞上写入中的文件,整理路径有误时说明原因。
    • 采集:YUJ 开头的番号不再被当成韩国 MIB 片跳过;损坏视频和上万部批量补资料不再让任务整项失败;重建 amane 桥的报错从第一行写起。
    • 关注:rule34video 的角色归入题材一排,已入库条目用 scripts/backfill_rule34video_characters.py 补上。
    • 关注:rule34.xxx 新条目恢复标签分类、按上传时刻显示时间;关注卡的标签移入文字栏、用中性底色,筛选无结果时空状态铺满整行。
    • 配置:有扫描任务时保存媒体库设置会先确认;卸载被在跑的任务拦下时写出是哪个任务。
    • 配置:macOS 中文系统里取消选择文件夹不再报错;无法弹出对话框或找不到 PowerShell 时提示不支持。
    • 复核:官方来源自动写入的字段,只有社区来源给出不同写法时不再进复核队列。
    • 界面:统计页环图悬停显示实际视频数;中日文夹英文的文件名省略时末尾不再被裁掉,调整窗口更快。
    • 界面:外链圆标遇到不合法的跳转地址不再报服务器错误;想看页的资源链接缺少大小时显示「大小未知」。
    • 播放:SMB 共享上的作品能找到同目录的外挂字幕,字幕列表不再报错。

    Full Changelog / 完整变更

    Windows 安装包、免安装包和 macOS DMG 都内置 Python、FFmpeg、untrunc、cloudflared 和人脸模型,装好即可使用;Docker 镜像适合 NAS 与 Linux 服务器。安装与使用见 Windows 使用说明、macOS 使用说明和 Docker 部署。

    下载选择

    平台下载说明
    Windows x64安装包首次安装推荐
    Windows x64轻量安装包不含工具,复用已装的或安装时联网下载
    Windows x64免安装包(ZIP)解压后运行 Peach.exe
    macOS Apple SiliconDMGM 系列芯片
    macOS IntelDMGIntel 处理器
    Docker / NASlongmeidao/peach:0.54.0NAS 与 Linux 服务器部署

    其余文件不用手动下载:update.zip 和 FFmpeg、untrunc、cloudflared、人脸模型 工具包由 Windows 更新器按需取用;*-corresponding-source.zip 是第三方工具的对应源码;SHA256SUMS.txt 用来核对文件。

    更新已有安装

    平台方法
    Windows「配置 → 应用与维护」检查更新,下载完成后确认重启;也可以直接运行新安装包
    macOS菜单栏「版本与更新」>「检查更新」;0.53.0 及更早版本先手动装一次新 DMG
    Docker拉取新镜像后重建容器,见 [Docker 部署](https://github.com/peach-mitao/peach/blob/master

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Peach

    A local-first video metadata scraper and media manager.

    Website · Download · Live demo · Documentation · 简体中文

    Release CI pipelines License Windows x64 macOS DMG Age restrictions

    Screenshots

    Video library with search, filters and posters

    Movie demo data; see asset credits and licenses.

    People and works

    Charlie Chaplin's profile and films

    Creator updates

    Creator follows and new works

    Library statistics

    Library, storage and viewing statistics

    Player

    Big Buck Bunny player

    Features

    • Metadata scraping: recognize video codes, read NFO files and fill titles, performers, studios and covers from multiple sources while keeping your edits.
    • Local and cloud libraries: browse local drives, SMB, mounted cloud storage and PikPak libraries together.
    • Playback and history: web and external players, subtitles, playback speed, rotation, resume and timeline previews.
    • Follows and discovery: track performer and creator updates, discover titles and manage a want list.
    • Cloud download: search by video code or submit a magnet link, then organize completed downloads into your library.
    • Library management: manage tags, duplicates, versions and parts; permanently delete videos by performer while keeping profiles and photos. Metadata and watch history are stored locally.
    • Task center: pause, resume or cancel local background tasks and view their CPU, GPU and download activity where available.

    Download and use

    MethodGet started
    Windows x64Installer · Portable
    macOSApple Silicon / ARM64 · Intel / x86_64
    Docker / NASDeployment guide
    SourceSetup instructions; requires Git, uv and Python 3.14+

    Choose your media folders after installation, then scan to start browsing and playing. Desktop test builds are unsigned, and macOS builds are not notarized. See the Windows and macOS guides.

    Documentation

    Operations · Sources · External players · Diagnostics and data sharing · Changelog

    Development: Contributing · Development guide · Testing

    Reporting problems

    Report a bug or suggest a feature with your version, steps and error message. Use demo data in public screenshots and redact private information; do not upload videos or databases. Report vulnerabilities privately through the security policy.

    Related projects

    Thanks to amane, Gfriends and CloudDrive2. See the reuse inventory for full credits.

    Star History

    License

    AGPL-3.0-or-later · Copyright (C) 2026 The Peach contributors. Third-party components retain their own licenses. Use of the Peach name and logo follows the name and logo policy.

    Manage only media you own or are authorized to use, subject to laws, copyright and source-platform access, age and regional restrictions. Peach does not provide video resources or access to paid content.