2021-10-11 23:32:13 +02:00
PhotoPrism: Browse Your Life in Pictures
========================================
2018-08-23 14:44:21 +02:00
2020-06-15 09:49:06 +02:00
[][license]
2020-08-13 17:46:54 +02:00
[][ci]
2019-04-29 17:20:33 +02:00
[](https://github.com/photoprism/photoprism/graphs/contributors/)
2020-06-07 13:26:13 +02:00
[][docs]
2019-01-09 06:03:03 +01:00
[][chat]
2021-10-23 20:34:01 +02:00
[][ask]
2021-05-15 10:48:37 +02:00
[][twitter]
2018-02-27 19:46:50 +01:00
2021-10-20 08:54:23 +02:00
PhotoPrism® is an AI-powered app for browsing, organizing & sharing your photo collection.
It makes use of the latest technologies to tag and find pictures automatically without getting in your way.
2021-10-18 21:47:03 +02:00
You can run it at home, on a private server, or in the cloud.
2018-09-27 15:46:20 +02:00
2021-10-18 12:54:49 +02:00
2018-09-26 15:35:34 +02:00
2020-12-26 13:40:26 +01:00
To get a first impression, you're welcome to play with our public demo at [demo.photoprism.org ](https://demo.photoprism.org/ ).
2021-10-18 17:09:32 +02:00
## Feature Overview ##
2018-09-27 15:46:20 +02:00
2021-10-14 19:26:33 +02:00
* Browse all your photos and [videos ](https://demo.photoprism.org/videos ) without worrying about RAW conversion, duplicates or video formats
2021-11-01 14:29:37 +01:00
* Easily find specific pictures using powerful [search filters ](https://demo.photoprism.org/browse?view=cards&q=flower%20color%3Ared )
2021-10-31 13:25:36 +01:00
* Privacy-friendly: No data is ever sent to Google, Amazon, Facebook, or Apple unless you explicitly upload files to one of their services 🔐
* Recognizes the faces of your [family and friends ](https://demo.photoprism.org/people ) 💎
* [Automatic classification ](https://demo.photoprism.org/labels ) of pictures based on their content and location 🌈
2021-11-01 14:29:37 +01:00
* 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 )
2021-10-12 12:58:55 +02:00
* Since the [user interface ](https://demo.photoprism.org/ ) is a [Progressive Web App ](https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps ),
2021-10-14 18:54:47 +02:00
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
2021-10-31 13:25:36 +01:00
* Includes four high-resolution [world maps ](https://demo.photoprism.org/places ) to bring back the memories of your favorite trips 🌍
2021-10-14 20:27:56 +02:00
* Metadata is extracted and merged from Exif, XMP, and other sources such as Google Photos
2021-10-15 13:11:32 +02:00
* Many more image properties like [colors ](https://demo.photoprism.org/browse?view=cards&q=color:red ), [chroma ](https://demo.photoprism.org/browse?view=cards&q=mono%3Atrue ), and [quality ](https://demo.photoprism.org/review ) can be searched as well
2021-10-31 13:58:01 +01:00
* 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
2020-11-27 18:14:56 +01:00
2020-11-26 20:45:48 +01:00
## Getting Started ##
2020-06-24 14:40:54 +02:00
2020-11-29 12:39:49 +01:00
Step-by-step installation instructions for our self-hosted [community edition ](https://photoprism.app/get ) can be found
2020-11-27 18:23:46 +01:00
on [docs.photoprism.org ](https://docs.photoprism.org/getting-started/ ) -
2021-10-01 05:12:36 +02:00
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.
2018-10-07 15:47:56 +02:00
2021-10-11 21:31:26 +02:00
Our [latest release ](https://docs.photoprism.org/release-notes/ ) not only includes
2021-10-01 05:12:36 +02:00
**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/ ).
2020-12-26 13:40:26 +01:00
2021-10-14 12:54:14 +02:00
## Back us on [Patreon](https://www.patreon.com/photoprism) or [GitHub Sponsors](https://github.com/sponsors/photoprism) ##
2020-01-04 20:19:50 +01:00
2021-10-14 12:54:14 +02:00
Your continued support helps us provide services like satellite maps and develop new features.
2021-11-01 14:29:37 +01:00
GitHub now also offers [one-time donations ](https://github.com/sponsors/photoprism?frequency=one-time ).
2021-11-02 14:45:37 +01:00
You're welcome to [contact us ](https://photoprism.app/contact ) for other options.
2021-10-08 14:54:24 +02:00
2020-06-15 14:40:46 +02:00
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.
2019-12-05 23:18:27 +01:00
2021-10-09 08:05:52 +02:00
Thank you very much! 💜
2021-10-07 15:20:58 +02:00
## Roadmap ##
2021-10-18 17:55:13 +02:00
Our vision is to provide the most user- and privacy-friendly solution to keep your pictures organized and accessible.
2021-10-07 15:20:58 +02:00
The [roadmap ](https://github.com/photoprism/photoprism/projects/5 ) shows what tasks are in progress,
2021-10-14 17:27:54 +02:00
what needs testing, and which features are going to be implemented next.
2021-10-07 15:20:58 +02:00
Please give ideas you like a thumbs-up 👍 , so that we know what is most popular.
2021-10-21 12:24:51 +02:00
You are welcome to submit specific feature requests via [GitHub Issues ](https://github.com/photoprism/photoprism/issues )
if you have verified that no similar [idea ](https://github.com/photoprism/photoprism/labels/idea ) or
[todo ](https://github.com/photoprism/photoprism/labels/todo ) already exists.
2021-11-02 14:45:37 +01:00
Ideas endorsed by silver, [gold and platinum sponsors ](SPONSORS.md ) receive a [golden label ](https://github.com/photoprism/photoprism/issues?q=is%3Aissue+is%3Aopen+label%3Asponsor ) and will be prioritized.
2021-10-21 12:24:51 +02:00
## Questions?
Follow us on [Twitter ](https://twitter.com/photoprism_app ) or join our [Community Chat ](https://gitter.im/browseyourlife/community )
2021-10-21 13:31:41 +02:00
to get regular updates, connect with other users, and discuss your ideas. Don't be afraid to ask silly questions.
2021-10-21 12:24:51 +02:00
2021-10-21 12:36:47 +02:00
## Getting Support ##
2021-10-21 12:24:51 +02:00
2021-10-31 15:34:57 +01:00
Please use [GitHub Issues ](https://github.com/photoprism/photoprism/issues ) only to report clearly identified bugs to us. If you are not sure, first use [GitHub Discussions ](https://github.com/photoprism/photoprism/discussions )
2021-10-21 12:24:51 +02:00
or ask in our [Community Chat ](https://gitter.im/browseyourlife/community ). [Sponsors ](https://docs.photoprism.org/funding/ )
receive direct [technical support ](https://photoprism.app/contact ) via email.
When reporting a problem, please include the version you are using and information
about your environment such as browser, operating system, installed memory, and
processor type.
2021-10-07 15:20:58 +02:00
## Contributions ##
2021-10-21 12:24:51 +02:00
We welcome contributions of any kind, including bug reports, testing, writing documentation,
tutorials, blog posts, and pull requests. Issues labeled
[help wanted ](https://github.com/photoprism/photoprism/labels/help%20wanted ) /
2021-10-07 15:20:58 +02:00
[easy ](https://github.com/photoprism/photoprism/issues?q=is%3Aissue+is%3Aopen+label%3Aeasy ) can be
2021-10-21 12:30:43 +02:00
good (first) contributions. Our step-by-step guide explains how to submit
[pull requests ](https://docs.photoprism.org/developer-guide/pull-requests/ ).
2021-10-07 15:20:58 +02:00
2020-06-23 13:44:14 +02:00
## Trademarks ##
2020-01-09 05:26:19 +01:00
2020-09-20 15:10:59 +02:00
PhotoPrism® is a registered trademark of Michael Mayer. You may use it as required to describe
2021-01-25 08:06:17 +01:00
our software, run your server, for educational purposes, but not for offering commercial
2020-06-23 13:44:14 +02:00
goods, products, or services without prior written permission. In other words, please ask.
2020-01-09 05:26:19 +01:00
2020-01-14 00:31:16 +01:00
[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
2018-11-19 04:24:43 +01:00
[license]: https://github.com/photoprism/photoprism/blob/develop/LICENSE
2019-12-30 13:03:34 +01:00
[patreon]: https://www.patreon.com/photoprism
2020-12-26 13:40:26 +01:00
[paypal]: https://www.paypal.me/photoprism
2018-11-20 09:23:45 +01:00
[goreport]: https://goreportcard.com/report/github.com/photoprism/photoprism
2018-11-19 04:24:43 +01:00
[coverage]: https://codecov.io/gh/photoprism/photoprism
2020-08-13 17:46:54 +02:00
[ci]: https://drone.photoprism.app/photoprism/photoprism
2020-06-07 13:14:20 +02:00
[docs]: https://docs.photoprism.org/
2018-12-20 19:35:52 +01:00
[issuehunt]: https://issuehunt.io/repos/119160553
2019-01-09 06:03:03 +01:00
[chat]: https://gitter.im/browseyourlife/community
2021-10-23 20:34:01 +02:00
[ask]: https://github.com/photoprism/photoprism/discussions
2021-05-15 10:52:16 +02:00
[twitter]: https://twitter.com/photoprism_app
2019-12-30 13:03:34 +01:00
[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
