github peach-mitao/peach v0.57.0

latest release: v0.58.0
pre-release8 days ago

Added

  • Settings: New capacity protection caps data and cache; over the cap it clears the oldest playback cache first and pauses background tasks, without blocking playback.
  • Settings: Settings adds Repairs and migrations, listing post-upgrade repair progress, items awaiting your confirmation and history.
  • Updates: After an upgrade, release notes pop up listing only entries relevant to this machine; reopen them from Check for updates.
  • Interface: Sidebar and Manage menu items can be reordered by dragging, and each group can reset to its default order.
  • Library: Scan and sourcing can target a single media library.
  • Sourcing: The JAV New releases page supports multi-select to add to Wants or search for sources in bulk.
  • Interface: Background tasks share a three-level speed control; activity history, cloud downloads, New releases, Wants and review lists get full pagination.
  • Sourcing: Adding cloud download tasks retries a limited number of times on temporary errors and shows accurate results when done.
  • Interface: Title cards without an image say what is missing and why, and can fetch the cover, fill in previews for that title or retry on the spot.
  • Interface: New performer, studio and title detail pages show Filling in while metadata completes, then refresh avatars and metadata without a page reload.
  • Interface: UI language follows browser and system; in English, sidebar and Manage menu come first, other pages follow over time; pin it under Appearance.
  • Interface: In the English UI, Library tools, Junk files, Duplicates and Media repair pages are in English.
  • Settings: Docker Compose deployments can set health check interval and container log rotation via env vars; logs default to 10 MB each, 3 kept (#502).

Highlights

  • Storage limits: Set limits for data and caches (#467).
  • Drag to reorder: Drag to reorder the sidebar and menus (#462).
  • Sync by library: Scan & fetch can target a single library (#462).
  • Select multiple new releases: Add several to Want or search torrents at once (#474).
  • Repairs: See upgrade repair progress and confirm cleaning up old follow snapshots.

Changed

  • Playback: Cloud drive videos aren't batch-measured for display size on upgrade; it starts once confirmed in Repairs and migrations and pauses on low system disk (#452).
  • Library: Preview fill-in is no longer local-only and also extracts frames in free cloud drive folders; targeted fill-in on data saver folders asks first.
  • Interface: Descriptions and confirmations on Library tools pages are shorter, keeping only scope, whether it can be undone and what is kept.
  • Settings: Upload collection and taste details adds capacity and playback activity summaries; if you enabled it before, agree again under Data sharing.
  • Interface: Removes hints explaining internals, such as No verified Chinese spelling yet under names, missing-duration reasons and the Stats header.

Fixed

  • Playback: Orientation uses display aspect ratio (SAR), so landscape videos with non-square pixels aren't treated as portrait; old videos are rechecked on upgrade (#433).
  • Library: Synology @eaDir, fnOS metadata and macOS ._ system files are no longer added; ones already added move to Trash on upgrade (#432).
  • Library: Scans skip the macOS .DocumentRevisions-V100 store at external drive roots instead of erroring when it can't be read.
  • Library: When only a file name's case changes, scans follow the on-disk spelling and Organize can change case alone, without file-not-found errors (#487).
  • Review: Candidates left by a permanently deleted asset move to the same file's new id, unmatched ones are withdrawn, ending No matching available asset errors (#486).
  • Review: Approve on tag candidates with only unlisted genres closes them directly instead of reporting Tag candidate is empty (#486).
  • Library: Upgrading removes performer links left by garbled early sourcing and re-fetches performers.
  • Following: New entries from background sync appear in the Following list again (regression from 0.56.0).
  • Playback: Header repair on long videos detects stalls by decoding progress instead of failing at a fixed 900-second timeout (#434).
  • Sourcing: Once a run's budget is spent, sourcing stops idling for hours; the task card shows how many remain for the next run, and the issue list logs one entry (#513).
  • Interface: Performer pages no longer link or subscribe to empty JavDB pages of old names matched by name; uncensored pages stay; upgrade checks local cache only.
  • Sourcing: When JavDB, DMM, MGS or other sites reject the current proxy exit, subscription and source checks say to switch exits instead of No entries could be read.
  • Updates: When Check for updates can't reach GitHub, it reads the version from the download mirror, no longer stuck at 0.50.0 or calling the current version newer (#454).
  • Sourcing: When JavDB has both FANZA-exclusive and regular editions of a video code, metadata scraping picks the regular one instead of reporting unclear identity (#431).
  • Sourcing: FC2 title performers are checked by identity; JavDB performers with unconfirmed identity are no longer filled in automatically.
  • Sourcing: After a cloud download finishes, the cloud drive folder is refreshed and import continues instead of stopping at unregistered.
  • Library: Interrupted scan tasks can restart when their process ID is taken by another program, instead of being treated as still running (#268).
  • Following: Each source keeps only its latest 3 raw snapshots plus those entries reference; older buildup can be deleted after confirming in Repairs and migrations.
  • Updates: Background tasks no longer leave state files in the data folder, and upgrading cleans up the tens of thousands left by older versions.
  • Updates: Video fill-in deletes its progress files when done, and upgrading cleans up the over ten thousand left by older versions.
  • Updates: Empty crash logs are deleted on normal exit, and upgrading cleans up empty logs left by older versions (#485).
  • Updates: Post-upgrade repairs wait when cloud drives are unmounted, sites cool down or capacity is over the cap; failed ones can be retried in Repairs and migrations.
  • Library: New files reported by push but still being written are registered after a server restart instead of being dropped.
  • Following: Mark all watched and Ignore all no longer miss items beyond 1000; they now commit in batches of 1000.
  • Following: Source backoff and cooldown persist across restarts, so rate-limited sites aren't retried right after a restart.
  • Sourcing: Performer metadata fill-in, metadata processing and video trailers share one javdb rate limit, at most 20 pages per minute in total.
  • Playback: Streaming no longer competes with page requests for threads, and playback heartbeats no longer make other pages reload.
  • Playback: Browsing the image wall or opening videos with subtitles skips the cloud drive when the local cache has a hit.
  • Interface: Library, Review, duplicates and junk score pages open and page faster in large libraries (#298).
  • Interface: While background tasks run, home, profile and Stats pages no longer refetch everything every two seconds, refreshing at most every half minute.
  • Interface: JAV Discover and New releases pages no longer recompute the whole page every 3 seconds while reading title metadata.
  • Interface: Opening the search box no longer fires a dozen stats requests; tasks with thousands of items list only running ones and the latest 50 in Tasks.
  • Settings: When a cloud drive hangs, Settings no longer stays loading; media folder online status comes from background checks.
  • Updates: While post-upgrade metadata fill-in is scheduled, the per-minute background check no longer rereads the seed pack, checks each performer or reads avatars.
  • Ledger: Errors midway through migrations, deletions and ledger restores roll back the whole step, leaving no mismatched references.
  • Settings: If HTTPS certificate issuance fails during First-time setup, it can be retried instead of staying half done.
  • Interface: Import notifications open title details directly, and the details tab shows the video code and file name.
  • Interface: Profile tabs opened by ID show the person's name, and Trash, JAV, portrait and search result tabs get their own titles.
  • Interface: When a video preview fails to load, a retry hint shows inside the original frame instead of breaking the layout.
  • Interface: Closing a popover with Esc no longer collapses the sidebar, and section pages no longer jump while loading.
  • Sourcing: Social media avatars are read from the person's own profile page, and title and new release cards update when the avatar changes.
  • Playback: JavDB trailers play when the local proxy uses Fake-IP.
  • Following: The Iwara source icon is visible in the light theme.
  • Interface: In the light theme, local and online source icons at the top left of title cards are no longer too faint to see.
Downloads

Windows installers, the portable ZIP and macOS DMGs bundle Python, FFmpeg, untrunc, cloudflared and the face models, so they work right after installing; the Docker image suits NAS and Linux servers. See the Windows guide, macOS guide and Docker deployment.

Platform Download Notes
Windows x64 Installer Recommended for a first install
Windows x64 Lite installer Without tools; reuses installed ones or downloads them during setup
Windows x64 Portable ZIP Extract and run Peach.exe
macOS Apple Silicon DMG M-series chips
macOS Intel DMG Intel processors
Docker / NAS longmeidao/peach:0.57.0
ghcr.io/peach-mitao/peach:0.57.0
Same image; use ghcr.io when Docker Hub pulls are limited

You do not need the other files: the Windows updater fetches update.zip and the FFmpeg, untrunc, cloudflared and face model tool packages as needed; *-corresponding-source.zip is the corresponding source of third-party tools; SHA256SUMS.txt verifies the files.

Updating an existing install

Platform How
Windows Settings → App and maintenance → Check for updates, then confirm the restart; or run the new installer
macOS Menu bar → Version and updates → Check for updates; 0.53.0 and earlier install the new DMG once by hand
Docker Pull the new image and recreate the container; with Watchtower, Settings offers one-click updates. See Docker deployment

macOS first install

Check the chip under About This Mac: Apple M-series takes Apple Silicon, Intel processors take Intel. Open the DMG, drag Peach to the Applications folder, then open it to finish setup.

The app is ad-hoc signed and not yet notarized by Apple. If macOS says it is damaged and cannot be opened, run sudo /usr/bin/xattr -rd com.apple.quarantine "/Applications/Peach.app" in Terminal and open it again; the password asked for is this Mac's login password and does not show while you type. The command only removes Peach's quarantine flag. Run it again after dragging in a new version by hand; installs through the in-app updater do not need it.

Docker

The edge tag always points to the newest release; pin a version with the versioned tags in the table above. See Docker deployment for setup, updates and rollback.

简体中文

重点

  • 容量保护:给数据和缓存设上限(#467)。
  • 拖动排序:侧栏和各类菜单都能拖动排序(#462)。
  • 按媒体库同步:扫描和采集可以只选一个库(#462)。
  • 新作多选:批量加入想要或查找资源(#474)。
  • 修复与迁移:查看升级修复的进度,确认清理关注旧快照。

新增

  • 配置:新增容量保护,可给数据和缓存设上限,超限时先清最旧的播放缓存、暂停后台任务,不挡播放。
  • 配置:设置里新增「修复与迁移」,列出升级后各项修复的进度、等你确认的项和历史记录。
  • 更新:升级后弹出这一版的更新说明,只列和这台机器有关的条目,检查更新里可以再次打开。
  • 界面:侧栏和管理菜单可以拖动排序,每个分组都能恢复默认顺序。
  • 馆藏:扫描与采集可以只选一个媒体库。
  • 采集: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 来源图标在浅色主题下看得见。
  • 界面:浅色主题下作品卡左上角的本地、在线来源图标不再淡得看不见。
下载

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

平台 下载 说明
Windows x64 安装包 首次安装推荐
Windows x64 轻量安装包 不含工具,复用已装的或安装时联网下载
Windows x64 免安装包(ZIP) 解压后运行 Peach.exe
macOS Apple Silicon DMG M 系列芯片
macOS Intel DMG Intel 处理器
Docker / NAS longmeidao/peach:0.57.0
ghcr.io/peach-mitao/peach:0.57.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 的隔离标记。手动拖入新版本后要再执行一次,经应用内更新安装的不需要。

Docker

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

Full Changelog

Don't miss a new peach release

NewReleases is sending notifications on new releases.