134 lines
10 KiB
Markdown
134 lines
10 KiB
Markdown
PhotoPrism: Browse Your Life in Pictures
|
||
========================================
|
||
|
||
[](https://docs.photoprism.app/license/)
|
||
[](https://photoprism.app/team)
|
||
[](https://docs.photoprism.app/)
|
||
[](https://gitter.im/browseyourlife/community)
|
||
[](https://github.com/photoprism/photoprism/discussions)
|
||
[](https://twitter.com/photoprism_app)
|
||
[](https://www.reddit.com/r/photoprism/)
|
||
|
||
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.
|
||
You can run it at home, on a private server, or in the cloud.
|
||
|
||
|
||
|
||
To get a first impression, you are welcome to play with our public demo at [demo.photoprism.app](https://demo.photoprism.app/)
|
||
(also available in [Deutsch](https://demo-de.photoprism.app/), [Français](https://demo-fr.photoprism.app/), and [汉语](https://demo-zh.photoprism.app/)).
|
||
|
||
## Feature Overview ##
|
||
|
||
* Browse [all your photos](https://docs.photoprism.app/user-guide/organize/browse/) and [videos](https://demo.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://demo.photoprism.app/browse?view=cards&q=flower%20color%3Ared)
|
||
* 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.app/people)
|
||
* [Automatic classification](https://demo.photoprism.app/labels) of pictures based on their content and location
|
||
* [Play Live Photos](https://demo.photoprism.app/live) by hovering over them in [albums](https://demo.photoprism.app/albums) and [search results](https://demo.photoprism.app/browse?view=cards&q=type%3Alive)
|
||
* Since the [User Interface](https://demo.photoprism.app/) 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.app/places) to bring back the memories of your favorite trips
|
||
* Metadata is extracted and merged from Exif, XMP, and other sources such as Google Photos
|
||
* Many more image properties like [Colors](https://demo.photoprism.app/browse?view=cards&q=color:red), [Chroma](https://demo.photoprism.app/browse?view=cards&q=mono%3Atrue), and [Quality](https://demo.photoprism.app/review) can be searched as well
|
||
* 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 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
|
||
|
||
## Getting Started ##
|
||
<img align="right" width="25%" src="https://photoprism.app/user/pages/01.home/03._screenshots/iphone-maps-hybrid-540px.png">
|
||
|
||
Step-by-step installation instructions for our self-hosted [community edition](https://photoprism.app/get) can be found
|
||
on [docs.photoprism.app](https://docs.photoprism.app/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.
|
||
|
||
The [stable version](https://docs.photoprism.app/release-notes/) and development
|
||
preview have been built into a single [multi-arch image](https://hub.docker.com/r/photoprism/photoprism) for 64-bit AMD, Intel,
|
||
and ARM processors. That means, [Raspberry Pi](https://docs.photoprism.app/getting-started/raspberry-pi/) 3 / 4 owners can pull
|
||
from the same repository, enjoy the exact same functionality, and can follow the regular
|
||
[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/).
|
||
|
||
Existing users are advised to update their `docker-compose.yml` config based on our examples
|
||
available at [dl.photoprism.app/docker](https://dl.photoprism.app/docker/).
|
||
|
||
## Back us on [Patreon](https://www.patreon.com/photoprism) or [GitHub Sponsors](https://github.com/sponsors/photoprism) 💎 ##
|
||
|
||
Your continued support helps us provide [regular updates](https://docs.photoprism.app/release-notes/)
|
||
and services like [world maps](https://demo.photoprism.app/places).
|
||
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/).
|
||
|
||
We currently have the following sponsorship options:
|
||
|
||
- [GitHub Sponsors](https://github.com/sponsors/photoprism) is priced in USD and also offers [one-time donations](https://github.com/sponsors/photoprism?frequency=one-time)
|
||
- [Patreon](https://www.patreon.com/photoprism) is priced in Euro and also offers yearly payments
|
||
- Stripe will be available in early 2022, so you can sign up directly in the app without having a Patreon or GitHub account
|
||
- You are welcome to [contact us](https://photoprism.app/contact) for [other options](SPONSORS.md#crypto-wallets)
|
||
|
||
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.
|
||
|
||
## Upcoming Features and Improvements ##
|
||
|
||
Our vision is to provide the most user- and privacy-friendly solution to keep your pictures organized and accessible.
|
||
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.
|
||
|
||
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 on the [roadmap](https://github.com/photoprism/photoprism/projects/5).
|
||
|
||
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.
|
||
|
||
## Getting Support ##
|
||
|
||
Before submitting a support request, please use our [Troubleshooting Checklists](https://docs.photoprism.app/getting-started/troubleshooting/)
|
||
to determine the cause of your problem. If this doesn't help, or you have other questions:
|
||
|
||
- you are welcome to join us on [Reddit](https://www.reddit.com/r/photoprism/)
|
||
- post your question in [GitHub Discussions](https://github.com/photoprism/photoprism/discussions)
|
||
- ask in our [Community Chat](https://gitter.im/browseyourlife/community)
|
||
|
||
In addition, [sponsors](https://github.com/photoprism/photoprism/blob/develop/SPONSORS.md) receive direct
|
||
[technical support](https://photoprism.app/contact) via email.
|
||
|
||
We'll do our best to answer all your questions. In return, we ask you to [back us](https://docs.photoprism.app/funding/)
|
||
on [Patreon](https://www.patreon.com/photoprism) or [GitHub Sponsors](https://github.com/sponsors/photoprism).
|
||
Think of "free software" as in "free speech," not as in "free beer". Thank you! 💜
|
||
|
||
### GitHub Issues ###
|
||
|
||
Don't report a bug unless you are sure you found a new problem that must be fixed directly in the app:
|
||
|
||
- Ask for [technical support](https://photoprism.app/contact) if you need help, it could be a local configuration issue, or a misunderstanding in how the software works
|
||
- This gives our team the opportunity to [improve the documentation](https://docs.photoprism.app/getting-started/troubleshooting/) and provide best-in-class support to you, instead of handling incomplete and/or duplicate bug reports
|
||
- When reporting a problem, always include the software versions you are using and other information about your environment such as [browser, browser plugins](https://docs.photoprism.app/getting-started/troubleshooting/browsers/), operating system, storage type, memory size, and processor
|
||
|
||
## Questions?
|
||
|
||
Follow us on [Twitter](https://twitter.com/photoprism_app) or join our [Community Chat](https://gitter.im/browseyourlife/community)
|
||
to get regular updates, connect with other users, and discuss your ideas.
|
||
Our [Code of Conduct](CODE_OF_CONDUCT.md) explains the "dos and don’ts."
|
||
|
||
## Every Contribution Makes a Difference ##
|
||
|
||
We welcome contributions of any kind, including blog posts, tutorials, testing, writing documentation, and pull requests.
|
||
[The Developer Guide contains all the information necessary for you to get started.](https://docs.photoprism.app/developer-guide/)
|
||
|
||
## PhotoPrism® Trademark ##
|
||
|
||
Our [Trademark and Brand Guidelines](https://photoprism.app/trademark), which may be updated
|
||
from time to time, describe how our Brand Assets may be used. It is important to us that any
|
||
permitted use of our Brand Assets is fair and meets the highest standards. To ensure this,
|
||
we reserve the right to object to any use or misuse in any jurisdiction worldwide.
|
||
|
||
## We Love Feedback ##
|
||
|
||
An important part of our journey is to explore new ways in product development and build better software through simplicity
|
||
and consistent use of community feedback. You are always [welcome to share your thoughts](https://photoprism.app/contact) with us.
|