102 lines
6.6 KiB
Markdown
102 lines
6.6 KiB
Markdown
PhotoPrism: Browse Your Life in Pictures
|
|
========================================
|
|
|
|
[][license]
|
|
[][goreport]
|
|
[][ci]
|
|
[](https://github.com/photoprism/photoprism/graphs/contributors/)
|
|
[][docs]
|
|
[][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](https://demo.photoprism.org/).
|
|
|
|
## Features ##
|
|
|
|
* Browse all your photos and videos without worrying about RAW conversion, duplicates or video formats
|
|
* Easily find specific pictures using powerful [search filters](https://demo.photoprism.org/browse?q=mono%3Atrue%20quality%3A3%20photo%3Atrue)
|
|
* Since the [user interface](https://demo.photoprism.org/) is a [Progressive Web App](https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps),
|
|
it provides a native app-like experience, and you can conveniently install it on the home screen of all major operating systems and mobile devices
|
|
* Includes four high-resolution [world maps](https://demo.photoprism.org/places) to see where you've been and for rediscovering long-forgotten shots
|
|
* Play Live Photos™ by hovering over them in [albums](https://demo.photoprism.org/albums) and [search results](https://demo.photoprism.org/browse?view=cards&q=type%3Alive)
|
|
* Enjoy privacy-preserving [face detection and recognition](https://demo.photoprism.org/people) 💎
|
|
* AI-powered [image classification](https://demo.photoprism.org/labels)
|
|
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](https://www.photosync-app.com/) to securely backup iOS and Android phones in the background
|
|
* WebDAV clients such as Microsoft's Windows Explorer and Apple's Finder can [connect](https://docs.photoprism.org/user-guide/sync/webdav/) 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](https://photoprism.app/get) can be found
|
|
on [docs.photoprism.org](https://docs.photoprism.org/getting-started/) -
|
|
all you need is a Web browser and [Docker](https://docs.docker.com/get-docker/) to run the server.
|
|
It is available for Mac, Linux, and Windows.
|
|
|
|
Our [latest release](https://docs.photoprism.org/release-notes/) not only includes
|
|
**facial recognition**, it also comes as a
|
|
**single [multi-arch image](https://hub.docker.com/r/photoprism/photoprism) 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](https://dl.photoprism.org/docker/).
|
|
|
|
## Back us on [Patreon](https://www.patreon.com/photoprism) or [GitHub Sponsors](https://github.com/sponsors/photoprism) ##
|
|
|
|
Your continued support helps us provide services like satellite maps and develop new features.
|
|
|
|
Feature requests endorsed by silver and [gold sponsors](SPONSORS.md) receive a [golden label](https://github.com/photoprism/photoprism/issues?q=is%3Aissue+is%3Aopen+label%3Asponsor) and will be prioritized.
|
|
Let us know when we mistakenly label an idea as [unfunded](https://github.com/photoprism/photoprism/issues?q=is%3Aissue+is%3Aopen+label%3Aunfunded).
|
|
|
|
Also, please [leave a star](https://github.com/photoprism/photoprism/stargazers) 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](https://github.com/photoprism/photoprism/projects/5) shows what tasks are in progress,
|
|
what needs testing, and which features 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](https://docs.photoprism.org/developer-guide/) before opening an issue.
|
|
Issues labeled [help wanted](https://github.com/photoprism/photoprism/labels/help%20wanted) /
|
|
[easy](https://github.com/photoprism/photoprism/issues?q=is%3Aissue+is%3Aopen+label%3Aeasy) can be
|
|
good (first) contributions.
|
|
|
|
Follow us on [Twitter][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.
|
|
|
|
[wiki:classification]: https://github.com/photoprism/photoprism/wiki/Image-Classification
|
|
[wiki:xmp]: https://github.com/photoprism/photoprism/wiki/XMP
|
|
[wiki:geocoding]: https://github.com/photoprism/photoprism/wiki/Geocoding
|
|
[wiki:raw]: https://github.com/photoprism/photoprism/wiki/Converting-RAW-to-JPEG
|
|
[license]: https://github.com/photoprism/photoprism/blob/develop/LICENSE
|
|
[patreon]: https://www.patreon.com/photoprism
|
|
[paypal]: https://www.paypal.me/photoprism
|
|
[goreport]: https://goreportcard.com/report/github.com/photoprism/photoprism
|
|
[coverage]: https://codecov.io/gh/photoprism/photoprism
|
|
[ci]: https://drone.photoprism.app/photoprism/photoprism
|
|
[docs]: https://docs.photoprism.org/
|
|
[issuehunt]: https://issuehunt.io/repos/119160553
|
|
[chat]: https://gitter.im/browseyourlife/community
|
|
[twitter]: https://twitter.com/photoprism_app
|
|
[unfunded issues]: https://github.com/photoprism/photoprism/issues?q=is%3Aissue+is%3Aopen+label%3Aunfunded
|
|
[sponsored issues]: https://github.com/photoprism/photoprism/issues?q=is%3Aissue+is%3Aopen+label%3Asponsor
|