photoprism/README.md

98 lines
6.5 KiB
Markdown
Raw Normal View History

2021-10-11 23:32:13 +02:00
PhotoPrism: Browse Your Life in Pictures
========================================
2018-08-23 14:44:21 +02:00
[![License: AGPL](https://img.shields.io/badge/license-AGPL-blue.svg)][license]
2018-12-19 05:39:12 +01:00
[![Code Quality](https://goreportcard.com/badge/github.com/photoprism/photoprism)][goreport]
[![Build Status](https://drone.photoprism.app/api/badges/photoprism/photoprism/status.svg?ref=refs/heads/develop)][ci]
2019-04-29 17:20:33 +02:00
[![GitHub contributors](https://img.shields.io/github/contributors/photoprism/photoprism.svg)](https://github.com/photoprism/photoprism/graphs/contributors/)
2020-06-07 13:26:13 +02:00
[![Documentation](https://img.shields.io/badge/read-the%20docs-4aa087.svg)][docs]
[![Community Chat](https://img.shields.io/badge/chat-on%20gitter-4aa087.svg)][chat]
2021-05-15 10:48:37 +02:00
[![Twitter](https://img.shields.io/badge/follow-@photoprism_app-00acee.svg)][twitter]
2018-02-27 19:46:50 +01:00
2021-10-18 15:29:21 +02:00
PhotoPrism® is an AI-Powered Open Source App for browsing, organizing & sharing your photo collection.
2021-10-18 16:26:40 +02:00
It runs where you need it, at home or in the cloud. Say goodbye to selling your privacy!
2018-09-27 15:46:20 +02:00
2021-10-18 12:54:49 +02:00
![](https://dl.photoprism.org/img/ui/desktop-1000px.jpg)
To get a first impression, you're welcome to play with our public demo at [demo.photoprism.org](https://demo.photoprism.org/).
2021-10-11 18:13:23 +02:00
## Features ##
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
* Easily find specific pictures using powerful [search filters](https://demo.photoprism.org/browse?view=cards&q=flower%20color%3Ared)
2021-10-14 20:27:56 +02: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-14 20:38:28 +02: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
* Recognizes the faces of your [family and friends](https://demo.photoprism.org/people) 💎
2021-10-15 08:48:57 +02:00
* [Automatic classification](https://demo.photoprism.org/labels) of pictures based on their content and location
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-13 08:43:30 +02: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-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.
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/).
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) ##
2021-10-14 12:54:14 +02:00
Your continued support helps us provide services like satellite maps and develop new features.
2021-10-15 17:07:34 +02:00
Ideas 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.
2021-10-08 14:54:24 +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.
2021-10-09 08:05:52 +02:00
Thank you very much! 💜
2021-10-07 15:20:58 +02:00
## Roadmap ##
2021-10-18 12:54:49 +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.
## 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
2018-11-19 04:24:43 +01:00
[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
2018-11-19 04:24:43 +01:00
[coverage]: https://codecov.io/gh/photoprism/photoprism
[ci]: https://drone.photoprism.app/photoprism/photoprism
[docs]: https://docs.photoprism.org/
2018-12-20 19:35:52 +01:00
[issuehunt]: https://issuehunt.io/repos/119160553
[chat]: https://gitter.im/browseyourlife/community
2021-05-15 10:52:16 +02:00
[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