photoprism/README.md
2021-10-13 15:39:19 +02:00

6.8 KiB

PhotoPrism: Browse Your Life in Pictures

License: AGPL Code Quality Build Status GitHub contributors Documentation Community Chat Twitter

PhotoPrism® is a privately hosted app for browsing, organizing, and sharing your photo collection. It makes use of the latest technologies without getting in your way. Say goodbye to uploading your visual memories to the cloud!

To get a first impression, you're welcome to play with our public demo at demo.photoprism.org.

Features

  • Browse all your photos and videos without worrying about RAW conversion, duplicates or video formats
  • Powerful search filters make it easy to find the right pictures
  • Since the user interface is a Progressive Web App, it provides a native app-like experience, and you can easily install it on the home screen of all major operating systems and mobile devices
  • Includes four high-resolution world maps to see where you've been and for rediscovering long-forgotten shots
  • Play Live Photos™ by hovering over them in albums and search results
  • Enjoy privacy-preserving face detection and recognition 💎
  • AI-powered image classification based on Google TensorFlow
  • Metadata is extracted and merged from Exif, XMP, and proprietary formats such as Google Photos JSON
  • Image properties like colors, chroma, luminance, quality, and location are automatically detected when you update the index or import files
  • Use PhotoSync to securely backup iOS and Android phones in the background
  • WebDAV clients such as Microsoft's Windows Explorer and Apple's Finder can connect directly to PhotoPrism, allowing you to open, edit, and delete files from your computer as if they were local

Getting Started

Step-by-step installation instructions for our self-hosted community edition can be found on docs.photoprism.org - all you need is a Web browser and Docker to run the server. It is available for Mac, Linux, and Windows.

Our latest release not only includes facial recognition, it also comes as a single multi-arch image for AMD64, ARM64, and ARMv7. That means you don't need to pull from different Docker repositories anymore. We recommend updating your existing docker-compose.yml config based on our examples.

Funding

This open-source project is made possible thanks to our sponsors. If you enjoy using PhotoPrism, please consider backing us on Patreon or GitHub Sponsors.

Your continued support helps us fund operating costs, provide services like satellite maps, and develop new features. Requests endorsed by silver and gold sponsors receive a golden label and will be prioritized. Let us know when we mistakenly label an idea as unfunded.

Also, please leave a star on GitHub if you like this project. It provides additional motivation to keep going.

Thank you very much! 💜

Roadmap

Our vision is to provide the most user-friendly solution for browsing, organizing, and sharing your photo collection. The roadmap shows what tasks are in progress, what needs testing, and which feature requests are going to be implemented next.

Please give ideas you like a thumbs-up 👍 , so that we know what is most popular.

Contributions

We welcome contributions of any kind. If you have a bug or an idea, read our guide before opening an issue. Issues labeled help wanted / easy can be good (first) contributions.

Follow us on Twitter to receive regular project updates and discuss development related topics. Don't be afraid to ask stupid questions.

Trademarks

PhotoPrism® is a registered trademark of Michael Mayer. You may use it as required to describe our software, run your server, for educational purposes, but not for offering commercial goods, products, or services without prior written permission. In other words, please ask.