peach README

The project's README from github.com/peach-mitao/peach. As one markdown file: README.md.

Peach

Peach

给自己用的私人影片馆藏:本地硬盘、网盘和关注的创作者,放在一个地方看。

官网 · 下载安装包 · 在线演示 · 介绍视频 · 问题反馈 · 需求看板 · 路线图 · 文档 · English

release CI 状态 license Windows x64 macOS 独立应用构建与安装 18+ 成人内容

https://github.com/user-attachments/assets/a5610874-e611-41bb-be22-7d99f0d64b62

18+ 仅供成年人管理自己的成人内容馆藏。仓库不含媒体或站点数据;连接外部站点需有相应账号和访问权。

能做什么

观看记录、收藏和设置保存在本机。扫描不动原文件;手动整理先预览,可撤回上一批。

扫描、关注更新和新作资料采集会保存进度,应用重启后继续处理未完成的项目。恢复范围见断点续跑。

「发送版本统计与错误诊断(推荐)」默认勾选,可在安装、首次设置或设置页取消。两类技术事件由同一开关控制,已保存的关闭选择会保留。启用后向 Sentry 发送页面列出的技术字段,不自动上传完整日志、诊断 ZIP、媒体信息或观看记录。见远程诊断说明。

馆藏与口味明细上传在安装器和设置页另设独立选项,默认关闭。设置页先展示完整字段与本机预览,经明确同意后,每周上传作品、标签、评分、观看汇总及全部偏好维度的明细;不含账号、设备或安装标识。明细仍有跨次关联与再识别风险,接收服务可见连接 IP。见馆藏与口味群体研究。

截图

在线演示 可直接体验搜索、筛选和资料页,操作不会保存。点击截图查看原图。

馆藏:首页筛选与作品卡片 女优页:人像、资料与全部作品
馆藏:按人物、来源和标签找片 女优页:资料、别名和全部作品
关注:创作者导航与图片更新 统计:馆藏、存储与内容分布
关注:创作者的跨站更新 统计:片子存在哪、看了多少
播放墙:全屏作品封面与浏览控件
播放墙:拖动挑片,原位播放

下载与使用

Windows

  1. 从 Releases 下载完整安装包 Peach-<版本>-windows-x64-setup.exe,双击安装,无需管理员权限;也可下载完整免安装包,解压后运行 Peach.exe。
  2. 浏览器打开首次设置页后,选择媒体目录和访问范围。
  3. 开始扫描,随后在浏览器里浏览和播放。

完整安装包携带媒体工具,可离线安装;轻量安装包体积更小,安装时按需下载工具。

测试版尚未签名。若 Windows 提示「已保护你的电脑」,确认来自本项目的 Release,再点「更多信息 → 仍要运行」。安装、更新和故障排查见 Windows 使用说明。

macOS 本机构建

macOS 可在本机构建独立 .app 与 DMG,运行不需要 Python、源码或另一台电脑。构建与安装见 macOS 独立测试包。

发版流程分别生成 Apple Silicon(macos-arm64.dmg)与 Intel(macos-x86_64.dmg)测试包;可下载版本以 Releases 的实际资产为准。在「关于本机」确认芯片,打开对应镜像并将 Peach 拖入「应用程序」。测试包未完成 Apple 公证,媒体工具需另行准备。

从源码运行(Windows、macOS)

需要 Git、uv 和 Python 3.14 或更高,步骤见源码运行。

Docker(VPS / NAS)

部署步骤与支持范围见 Docker 部署。

常见问题

问题反馈

先查看用户反馈,或提交问题,附上版本、操作步骤、预期与实际结果。截图请遮掉凭据、局域网地址和完整路径,不要上传数据库或媒体;安全问题按安全政策私下报告。

文档

运行与配置 · 来源采集 · 外部播放器 · 变更日志

参与开发:开发约定 · 测试与依赖

相关项目

感谢 amane、Gfriends、CloudDrive2 等项目,完整致谢与复用说明见复用清单。

Star 历史

Peach Star 历史

许可证

AGPL-3.0-or-later · Copyright (C) 2026 longmeidao。第三方组件保留各自的许可证。

peach (peach-mitao/peach)

home-server
Searching Database…

11.7K ·GitHub
What is this?Peach is a single-user, local-first personal media system that brings together your local disk, mounted cloud drives, and followed creators into one private library. It is explicitly built for adults to manage adult-content (JAV) collections.
Is this a hosted web app or software I run myself?It is self-hosted software you run on your own machine or server — a Windows installer/portable app, a macOS app you build locally, or a Docker deployment for a VPS/NAS. There is no official hosted service.
How do I get it running on Windows?Download the full installer package 'Peach-*-windows-x64-setup.exe' from Releases and run it (no admin rights needed), or grab the portable zip and run Peach.exe. Then open the first-time setup page in your browser to pick a media folder and start scanning.
Do I need to mount my cloud drives myself first?Yes — network drives like 115, PikPak, or OneDrive need to already be mounted as local folders (e.g. via CloudDrive2) for Peach to include them in the library. Cloud download to 115/PikPak works separately through its own login tokens.
Does scanning or organizing touch my original files?Scanning and metadata fetching never modify the original files. Manual organizing can rename or move files, and emptying the trash (or cleanup during resource sync) will delete files or empty folders — both require confirmation first.
How does the cloud download feature work?You paste a magnet link or search by the JAV code, submit it to 115 or PikPak, and once the download finishes Peach automatically organizes it into your library.
Can I add videos while browsing sites like JavDB or MissAV?A separately maintained browser userscript lets you recognize or select a title code on sites like JavDB, MissAV, and Jable and send it straight to Peach's cloud downloader.
What happens if a scan is interrupted?Scanning, follow-update checks, and new-release discovery all save progress, so Peach resumes unfinished work automatically after a restart.
Can I watch my collection on my phone?During first-time setup you can allow access from other devices on the same local network; just open the given address on your phone and set an access password.
Size
70.4 MB
Stars
11.7K
Updated
CommitOct 19
Age
2mo
Commits · 90 Days