pomelosky/plex2stash repository overview

⁠Plex2Stash

A powerful bi-directional metadata provider for Plex that seamlessly integrates with Stash, enabling automatic metadata syncing for adult media libraries.

⁠🚀 Features

• 🔗 Stash GraphQL integration — Sync scenes, performers, studios, and tags into Plex
• 🎯 Smart matching override — Improves Plex matching accuracy (especially for Japanese titles)
• 📺 TV show hierarchy support — Full Show → Season → Episode structure
• 🧠 Field-level sync control — Customize which metadata fields are synced
• 🖼️ Image proxy support — No need to expose your Stash API key
• 🔁 Multi-provider fallback — Priority-based metadata sources
• ⚡ LRU caching — Improves performance and avoids DB locks
• 📜 Built-in logging UI — View logs directly from the web interface
• 🌍 Multi-language support — English, 中文, 日本語
• 🐳 Docker & Synology NAS ready

⁠📦 Quick Start

docker run -d \
  -p 8787:8787 \
  -p 3000:3000 \
  -v /path/to/data:/data \
  --name plex2stash \
  pomelosky/plex2stash:latest

⁠🌐 Access

• Web UI: http://localhost:3000⁠
• Plex Provider API: http://localhost:8787⁠

⁠⚙️ Setup

1. Open Web UI and configure your Stash instance
2. In Plex → Settings → Agents → Add custom provider
3. Use provider URL:

http://YOUR_HOST:8787/providers/YOUR_STASH_ID

⁠📁 Data Directory

All configuration and logs are stored in:

/data

⁠🔗 Links

• GitHub: https://github.com/PomeloSky/plex2stash⁠
• Issues & Support: https://github.com/PomeloSky/plex2stash/issues⁠

⁠📄 License

MIT License

⁠💖 Support the Project

If you find this project useful, consider supporting development 🙏