2021-10-11 23:32:13 +02:00
PhotoPrism: Browse Your Life in Pictures
========================================
2018-08-23 14:44:21 +02:00
2021-12-30 11:45:01 +01:00
[![License: AGPL ](https://img.shields.io/badge/license-AGPL-blue.svg )](https://docs.photoprism.app/license/)
[![GitHub contributors ](https://img.shields.io/github/contributors/photoprism/photoprism.svg )](https://photoprism.app/team)
[![Documentation ](https://img.shields.io/badge/read-the%20docs-4aa087.svg )](https://docs.photoprism.app/)
2022-02-09 18:27:50 +01:00
[![Community Chat ](https://img.shields.io/badge/chat-on%20gitter-4aa087.svg )](https://link.photoprism.app/chat)
[![GitHub Discussions ](https://img.shields.io/badge/ask-%20on%20github-4d6a91.svg )](https://link.photoprism.app/discussions)
[![Twitter ](https://img.shields.io/badge/follow-@photoprism_app-00acee.svg )](https://link.photoprism.app/twitter)
[![Reddit ](https://img.shields.io/badge/join-/r/photoprism-EC5800.svg )](https://link.photoprism.app/reddit)
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-12-12 20:15:52 +01:00
![](https://dl.photoprism.app/img/ui/desktop-1000px.jpg)
2018-09-26 15:35:34 +02:00
2022-02-09 20:30:44 +01:00
To get a first impression, you are welcome to play with our [public demo ](https://try.photoprism.app/ ). Be careful not to upload any private pictures.
2020-12-26 13:40:26 +01:00
2021-10-18 17:09:32 +02:00
## Feature Overview ##
2018-09-27 15:46:20 +02:00
2022-02-09 18:27:50 +01:00
* Browse [all your photos ](https://docs.photoprism.app/user-guide/organize/browse/ ) and [videos ](https://try.photoprism.app/videos ) without worrying about [RAW conversion, duplicates or video formats ](https://docs.photoprism.app/user-guide/settings/library/ )
* Easily find specific pictures using [powerful search filters ](https://try.photoprism.app/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 🔐
2022-02-09 18:27:50 +01:00
* Recognizes [the faces of your family and friends ](https://try.photoprism.app/people )
* [Automatic classification ](https://try.photoprism.app/labels ) of pictures based on their content and location
* [Play Live Photos ](https://try.photoprism.app/live ) by hovering over them in [albums ](https://try.photoprism.app/albums ) and [search results ](https://try.photoprism.app/browse?view=cards&q=type%3Alive )
* Since the [User Interface ](https://try.photoprism.app/ ) 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
2022-02-09 18:27:50 +01:00
* Includes four high-resolution [World Maps ](https://try.photoprism.app/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
2022-02-09 18:27:50 +01:00
* Many more image properties like [Colors ](https://try.photoprism.app/browse?view=cards&q=color:red ), [Chroma ](https://try.photoprism.app/browse?view=cards&q=mono%3Atrue ), and [Quality ](https://try.photoprism.app/review ) can be searched as well
* Use [PhotoSync ](https://link.photoprism.app/photosync ) to securely backup iOS and Android phones in the background
2021-12-12 20:14:07 +01:00
* WebDAV clients such as Microsoft's Windows Explorer and Apple's Finder [can connect directly ](https://docs.photoprism.app/user-guide/sync/webdav/ ) 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 ##
2021-12-10 15:45:45 +01:00
< img align = "right" width = "25%" src = "https://photoprism.app/user/pages/01.home/03._screenshots/iphone-maps-hybrid-540px.png" >
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
2021-12-12 20:14:07 +01:00
on [docs.photoprism.app ](https://docs.photoprism.app/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-12-12 20:14:07 +01:00
The [stable version ](https://docs.photoprism.app/release-notes/ ) and development
2022-02-09 18:27:50 +01:00
preview have been built into a single [multi-arch image ](https://link.photoprism.app/docker-hub ) for 64-bit AMD, Intel,
2021-12-12 20:14:07 +01:00
and ARM processors. That means, [Raspberry Pi ](https://docs.photoprism.app/getting-started/raspberry-pi/ ) 3 / 4 owners can pull
2021-12-10 22:38:47 +01:00
from the same repository, enjoy the exact same functionality, and can follow the regular
2021-12-12 20:14:07 +01:00
[installation instructions ](https://docs.photoprism.app/getting-started/docker-compose/ )
after going through a short list of [requirements ](https://docs.photoprism.app/getting-started/raspberry-pi/ ).
2021-12-10 22:38:47 +01:00
Existing users are advised to update their `docker-compose.yml` config based on our examples
2021-12-12 20:19:55 +01:00
available at [dl.photoprism.app/docker ](https://dl.photoprism.app/docker/ ).
2020-12-26 13:40:26 +01:00
2022-02-09 18:27:50 +01:00
## Back us on [Patreon](https://link.photoprism.app/patreon) or [GitHub Sponsors](https://link.photoprism.app/sponsor) 💎 ##
2020-01-04 20:19:50 +01:00
2022-01-17 10:53:38 +01:00
**PhotoPrism is 100% self-funded and independent.** Your continued support helps us provide [regular updates ](https://docs.photoprism.app/release-notes/ )
2022-02-09 18:27:50 +01:00
and services like [world maps ](https://try.photoprism.app/places ).
2021-12-20 12:35:06 +01:00
Sponsors get access to [additional features ](https://github.com/photoprism/photoprism/issues?q=label%3Asponsor-feature ),
receive direct [technical support ](https://photoprism.app/contact ) via email, and can join our private chat room
on [matrix.org ](https://matrix.org/ ).
2021-12-13 03:45:52 +01:00
We currently have the following sponsorship options:
2021-10-08 14:54:24 +02:00
2022-02-09 18:27:50 +01:00
- [GitHub Sponsors ](https://link.photoprism.app/sponsor ) is priced in USD and also offers [one-time donations ](https://link.photoprism.app/donate )
- [Patreon ](https://link.photoprism.app/patreon ) is priced in Euro and also offers yearly payments
2021-12-20 12:35:06 +01:00
- Stripe will be available in early 2022, so you can sign up directly in the app without having a Patreon or GitHub account
2022-02-02 21:21:15 +01:00
- you are welcome to [contact us ](https://photoprism.app/contact ) for [crypto donations ](https://photoprism.app/crypto-donations ) and other options
2021-12-13 03:45:52 +01:00
Also, please [leave a star ](https://github.com/photoprism/photoprism/stargazers ) on GitHub if you like this project.
2020-06-15 14:40:46 +02:00
It provides additional motivation to keep going.
2019-12-05 23:18:27 +01:00
2022-01-15 17:23:43 +01:00
## Upcoming Features and Improvements ##
2022-01-17 13:37:30 +01:00
**Our vision is to provide the most user- and privacy-friendly solution to keep your pictures organized and accessible.**
2022-02-09 18:27:50 +01:00
The [roadmap ](https://link.photoprism.app/roadmap ) shows what tasks are in progress,
2022-01-15 17:23:43 +01:00
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.
2022-02-09 18:27:50 +01:00
Ideas endorsed by [silver, gold, and platinum sponsors ](https://link.photoprism.app/sponsors ) receive a [golden label ](https://github.com/photoprism/photoprism/issues?q=is%3Aissue+is%3Aopen+label%3Asponsor )
and will be prioritized on the [roadmap ](https://link.photoprism.app/roadmap ).
2022-01-15 17:23:43 +01:00
We have a zero bug policy and do our best to help users when they need support or have other questions.
This comes at a price, as we can't give exact deadlines for new features.
Having said that, funding really has the highest impact. So users can do their part and
[become a sponsor ](https://docs.photoprism.app/funding/ ) to get their favorite features as soon as possible.
2021-12-13 03:45:52 +01:00
## Getting Support ##
2022-01-11 20:19:17 +01:00
Before submitting a support request, please use our [Troubleshooting Checklists ](https://docs.photoprism.app/getting-started/troubleshooting/ )
2022-01-10 12:57:25 +01:00
to determine the cause of your problem. If this doesn't help, or you have other questions:
2021-12-13 03:45:52 +01:00
2022-02-09 18:27:50 +01:00
- you are welcome to join us on [Reddit ](https://link.photoprism.app/reddit )
- post your question in [GitHub Discussions ](https://link.photoprism.app/discussions )
- or ask in our [Community Chat ](https://link.photoprism.app/chat )
2021-12-13 03:45:52 +01:00
2022-02-09 18:27:50 +01:00
In addition, [sponsors ](https://link.photoprism.app/sponsors ) receive direct
2021-12-13 03:45:52 +01:00
[technical support ](https://photoprism.app/contact ) via email.
2021-12-31 13:11:10 +01:00
We'll do our best to answer all your questions. In return, we ask you to [back us ](https://docs.photoprism.app/funding/ )
2022-02-09 18:27:50 +01:00
on [Patreon ](https://link.photoprism.app/patreon ) or [GitHub Sponsors ](https://link.photoprism.app/sponsor ).
2022-02-01 20:06:42 +01:00
Think of "free software" as in "free speech," not as in "free beer". Thank You! 💜
2021-12-13 03:45:52 +01:00
2022-01-15 17:10:43 +01:00
### GitHub Issues ###
2022-01-27 16:44:04 +01:00
We kindly ask you not to report bugs via GitHub Issues unless you are certain to have found a fully reproducible and
previously unreported issue that must be fixed directly in the app. [Contact us ](https://photoprism.app/contact )
2022-02-09 18:27:50 +01:00
or [a community member ](https://link.photoprism.app/discussions ) if you need help, it could be a local
2022-01-27 16:44:04 +01:00
configuration problem, or a misunderstanding in how the software works. This gives our team the opportunity
2022-01-17 14:41:05 +01:00
to [improve the documentation ](https://docs.photoprism.app/getting-started/troubleshooting/ ) and provide best-in-class
support to you, instead of handling unclear and/or duplicate bug reports.
2021-10-09 08:05:52 +02:00
2022-01-17 08:44:00 +01:00
## Join the Community ##
2021-10-21 12:24:51 +02:00
2022-02-09 18:27:50 +01:00
Follow us on [Twitter ](https://link.photoprism.app/twitter ) and join the [Community Chat ](https://link.photoprism.app/chat )
2021-12-25 10:28:22 +01:00
to get regular updates, connect with other users, and discuss your ideas.
2022-02-09 20:30:44 +01:00
Our [Code of Conduct ](https://photoprism.app/code-of-conduct ) explains the "dos and don’ ts."
2021-10-21 12:24:51 +02:00
2022-01-17 08:44:00 +01:00
An important part of our journey is to explore new ways in product development and build better software through consistent use of community feedback. Feel free to [share your thoughts ](https://photoprism.app/contact ) with us at any time.
2022-01-16 19:13:01 +01:00
2022-01-13 20:00:08 +01:00
## Every Contribution Makes a Difference ##
2021-10-07 15:20:58 +02:00
2022-01-17 13:27:57 +01:00
We welcome [contributions ](CONTRIBUTING.md ) of any kind, including blog posts, tutorials, testing, writing documentation, and pull requests. Our [Developer Guide ](https://docs.photoprism.app/developer-guide/ ) contains all the information necessary for you to get started.
2022-01-13 19:58:37 +01:00
2022-01-16 18:50:30 +01:00
----
2022-02-09 18:27:50 +01:00
*PhotoPrism® is a [registered trademark ](https://photoprism.app/trademark ). Docs are [available ](https://link.photoprism.app/github-docs ) under the [CC BY-NC-SA 4.0 License ](https://creativecommons.org/licenses/by-nc-sa/4.0/ ); [additional terms ](https://github.com/photoprism/photoprism/blob/develop/assets/README.md ) may apply. By using our software, you agree to our [terms of service ](https://photoprism.app/terms ).*