README.md
Rama master · réplica de lectura del repositorio original.
<p align="center"><img src="resources/peach-logo-128.png" alt="Peach" width="88"></p>
# Peach
A local-first video metadata scraper and media manager.
[Website](https://peach.video) · [Download](#download-and-use) · [Live demo](https://demo.peach.video) · [Documentation](#documentation) · [简体中文](README.zh-CN.md)
[](https://github.com/peach-mitao/peach/releases)
[](https://github.com/peach-mitao/peach/actions/workflows/test.yml)
[](LICENSE)
[](docs/TESTING_DESKTOP.md)
[](docs/OPERATIONS.md#macos-独立测试包)
[](#license)
## Screenshots
[](https://peach.video/assets/screenshots/home-wide-20261025-2.png)
Movie demo data; see [asset credits and licenses](https://peach.video/en/credits/).
<details>
<summary>More screenshots</summary>
**People and works**
[](https://peach.video/assets/screenshots/profile-wide-20261025-2.png)
**Creator updates**
[](https://peach.video/assets/screenshots/follow-wide-20261025-2.png)
**Library statistics**
[](https://peach.video/assets/screenshots/stats-wide-20261025-3.png)
**Player**
[](https://peach.video/assets/screenshots/play-wide-20261025-2.png)
</details>
## 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
| Method | Get started |
| --- | --- |
| Windows x64 | [Installer](https://github.com/peach-mitao/peach/releases/download/v0.57.0/Peach-0.57.0-windows-x64-setup.exe) · [Portable](https://github.com/peach-mitao/peach/releases/download/v0.57.0/Peach-0.57.0-windows-x64.zip) |
| macOS | [Apple Silicon / ARM64](https://github.com/peach-mitao/peach/releases/download/v0.57.0/Peach-0.57.0-macos-arm64.dmg) · [Intel / x86_64](https://github.com/peach-mitao/peach/releases/download/v0.57.0/Peach-0.57.0-macos-x86_64.dmg) |
| Docker / NAS | [Deployment guide](docs/DOCKER.md) |
| Source | [Setup instructions](docs/OPERATIONS.md#从源码运行windowsmacos); 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](docs/TESTING_DESKTOP.md) and [macOS](docs/OPERATIONS.md#macos-独立测试包) guides.
## Documentation
[Operations](docs/OPERATIONS.md) · [Sources](docs/SOURCING.md) · [External players](docs/EXTERNAL_PLAYERS.md) · [Diagnostics and data sharing](docs/DIAGNOSTICS.md) · [Changelog](CHANGELOG.md)
Development: [Contributing](CONTRIBUTING.md) · [Development guide](AGENTS.md) · [Testing](docs/TESTING.md)
## Reporting problems
[Report a bug or suggest a feature](https://github.com/peach-mitao/peach/issues/new/choose) 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](SECURITY.md).
## Related projects
Thanks to [amane](https://github.com/sqzw-x/amane), [Gfriends](https://github.com/gfriends/gfriends) and [CloudDrive2](https://www.clouddrive2.com/). See the [reuse inventory](docs/REUSE.md) for full credits.
## Star History
<a href="https://github.com/peach-mitao/peach/tree/star-history">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/peach-mitao/peach/star-history/star-history-dark.svg">
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/peach-mitao/peach/star-history/star-history-light.svg">
<img alt="Peach cumulative stars, linear scale" src="https://raw.githubusercontent.com/peach-mitao/peach/star-history/star-history-light.svg">
</picture>
</a>
## License
[AGPL-3.0-or-later](LICENSE) · 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](docs/TRADEMARKS.md).
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.