Peach

Peach

Docker app from josywong's Repository

Peach is a local-first video metadata scraper and media manager for self-hosted VPS and NAS deployments, with a browser-based web UI.

Overview
Peach is a local-first video metadata scraper and media manager for self-hosted VPS and NAS deployments, with a browser-based web UI. The image contains the full runtime. No desktop client is needed. For the complete documentation, see https://github.com/peach-mitao/peach/blob/master/docs/DOCKER.md

Peach

Peach

A local-first video metadata scraper and media manager.

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

Release CI pipelines License Translation status Windows x64 macOS DMG Age restrictions

Screenshots

Video library with search, filters and posters

Movie demo data; see asset credits and licenses.

More screenshots

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

Method Get started
Windows x64 Installer · Portable
macOS Apple Silicon / ARM64 · Intel / x86_64
Docker / NAS Deployment guide
Source Setup 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.

Translation

Peach is translated on Hosted Weblate. The current English is an AI draft, so suggestions and votes are welcome. See Contributing for the details.

Related projects

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

Star History

Peach cumulative stars, linear scale

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.

Categories

Download Statistics

61,679
Total Downloads

Related apps

Explore more like this

Explore all

Links

Details

Repository
longmeidao/peach:edge
Last Updated2026-11-09
First Seen2026-11-16

Runtime arguments

Web UI
http://[IP]:[PORT:8900]
Network
bridge
Privileged
false
Extra Params
--init --stop-timeout 75 --hostname peach --user 99:100 --env HOME=/data

Template configuration

Config DirectoryPathrw

Peach configuration, SQLite database, credentials and image cache. Must be persistent.

Target
/data
Default
/mnt/user/appdata/peach
Media DirectoryPathro

Media files. Read-only by default; change to read-write only when organizing or deleting media.

Target
/media
Default
/mnt/user/media
User IDVariable

ID of the user the application runs as.

Target
PEACH_UID
Default
99
Group IDVariable

ID of the group the application runs as.

Target
PEACH_GID
Default
100
Access PasswordVariable

Optional access password, 8-256 characters. If empty, the first-run page asks for one.

Target
PEACH_ACCESS_PASSWORD
WebUI PortPorttcp

Port for the Peach web UI.

Target
8900
Default
8900