2018-10-05 19:19:46 +02:00
|
|
|
PhotoPrism: Browse your life in pictures
|
2018-10-05 08:27:45 +02:00
|
|
|
========================================
|
2018-08-23 14:44:21 +02:00
|
|
|
|
2018-12-19 05:39:12 +01:00
|
|
|
[![License: GPL](https://img.shields.io/badge/license-GPL-blue.svg)][license]
|
|
|
|
[![Code Quality](https://goreportcard.com/badge/github.com/photoprism/photoprism)][goreport]
|
2018-10-31 03:05:51 +01:00
|
|
|
[![Build Status](https://travis-ci.org/photoprism/photoprism.png?branch=develop)][ci]
|
2018-10-08 19:01:41 +02:00
|
|
|
[![Documentation](https://readthedocs.org/projects/photoprism-docs/badge/?version=latest&style=flat)][docs]
|
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/)
|
2019-01-09 06:03:03 +01:00
|
|
|
[![Community Chat](https://img.shields.io/badge/chat-on%20gitter-4aa087.svg)][chat]
|
2019-07-04 18:41:17 +02:00
|
|
|
[![Twitter](https://img.shields.io/badge/follow-@browseyourlife-00acee.svg)][twitter]
|
2018-02-27 19:46:50 +01:00
|
|
|
|
2018-10-13 17:40:57 +02:00
|
|
|
PhotoPrism is a server-based application for browsing, organizing and sharing your personal photo collection.
|
|
|
|
It makes use of the latest technologies to automatically tag and find pictures without getting in your way.
|
|
|
|
Say goodbye to solutions that force you to upload your visual memories to the cloud or pay monthly fees.
|
2018-09-27 15:46:20 +02:00
|
|
|
|
2018-12-19 00:24:02 +01:00
|
|
|
![](https://dl.photoprism.org/assets/img/preview.jpg)
|
2018-09-26 15:35:34 +02:00
|
|
|
|
2018-10-07 15:05:17 +02:00
|
|
|
More screenshots: https://photoprism.org/#screenshots
|
|
|
|
|
2019-01-09 06:38:56 +01:00
|
|
|
## What to expect ##
|
2018-09-27 15:46:20 +02:00
|
|
|
|
2018-10-05 16:31:57 +02:00
|
|
|
* Clearly structured Web interface for browsing, organizing and sharing your personal photo collection.
|
|
|
|
* Import everything without worrying about duplicates or RAW to JPEG conversion.
|
|
|
|
* Reverse geocoding and automated tagging based on Google TensorFlow.
|
|
|
|
* No monthly costs. No proprietary formats. No privacy concerns.
|
2018-09-27 22:40:38 +02:00
|
|
|
|
2019-01-09 06:38:56 +01:00
|
|
|
## For the early birds ##
|
2018-10-07 15:47:56 +02:00
|
|
|
|
2018-12-16 14:04:54 +01:00
|
|
|
You're welcome to play with our demo at [demo.photoprism.org](https://demo.photoprism.org).
|
|
|
|
Leave your email to get a [release notification](https://goo.gl/forms/KBPVGl9PCsOKrAv33).
|
2018-12-16 16:32:24 +01:00
|
|
|
|
2018-12-16 14:04:54 +01:00
|
|
|
Step-by-step [installation instructions](https://docs.photoprism.org/en/latest/setup/) can be found
|
2018-10-13 19:24:05 +02:00
|
|
|
in our [User Guide](https://docs.photoprism.org/en/latest/).
|
2018-10-09 22:51:58 +02:00
|
|
|
Developers can skip this and move on to the [Developer Guide](https://github.com/photoprism/photoprism/wiki).
|
2018-10-07 15:47:56 +02:00
|
|
|
|
2018-10-13 19:54:29 +02:00
|
|
|
All you need is a Web browser and [Docker](https://store.docker.com/search?type=edition&offering=community)
|
|
|
|
to run the server. It is available for Mac, Linux and Windows.
|
2019-12-16 12:59:03 +01:00
|
|
|
|
|
|
|
Note that this is work in progress. We do our best to provide a complete, stable version.
|
|
|
|
Financial [support](SPONSORS.md) makes a huge difference and enables us to spend more time with this project.
|
2018-11-22 20:42:04 +01:00
|
|
|
|
2019-12-30 13:03:34 +01:00
|
|
|
If you have a question, don't hesitate to ask in our [help forum][help]
|
2018-11-22 21:20:55 +01:00
|
|
|
or [contact us via email](mailto:hello@photoprism.org).
|
2018-10-13 19:54:29 +02:00
|
|
|
|
2019-01-09 06:38:56 +01:00
|
|
|
## Why this has to be free software ##
|
2018-10-07 15:47:56 +02:00
|
|
|
|
2018-10-13 17:28:53 +02:00
|
|
|
The development of every commercial product is focused on monetization.
|
2019-12-30 13:03:34 +01:00
|
|
|
We've [built similar apps more than once](https://github.com/photoprism/photoprism/wiki/Mediencenter)
|
|
|
|
and every single time the constraints of working
|
2018-10-13 17:28:53 +02:00
|
|
|
in a profit-oriented corporate environment were an impediment.
|
2018-12-16 15:13:52 +01:00
|
|
|
|
2019-12-30 13:03:34 +01:00
|
|
|
We are sure we can do better with only a fraction of the budget. Simplicity - the art of maximizing the
|
|
|
|
amount of work not done - can be very powerful.
|
2018-12-20 20:55:48 +01:00
|
|
|
Go itself is a [great example](https://talks.golang.org/2015/simplicity-is-complicated.slide).
|
2018-10-07 15:47:56 +02:00
|
|
|
|
2019-12-30 13:03:34 +01:00
|
|
|
Our long-term goal is to become an open platform for machine
|
|
|
|
learning [research](https://github.com/photoprism/photoprism/wiki/Research) based on real-world photo collections.
|
2018-12-16 15:37:46 +01:00
|
|
|
|
2019-01-09 06:38:56 +01:00
|
|
|
## How to contribute ##
|
2018-10-05 16:31:57 +02:00
|
|
|
|
2018-10-13 17:38:02 +02:00
|
|
|
We welcome contributions of any kind. If you have a bug or an idea, read our
|
|
|
|
[guide](https://docs.photoprism.org/en/latest/contribute/) before opening an issue.
|
2018-11-22 20:02:24 +01:00
|
|
|
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
|
2018-12-20 16:02:22 +01:00
|
|
|
good (first) contributions.
|
|
|
|
|
2019-12-30 13:03:34 +01:00
|
|
|
You'll get a small reward for working on [funded issues](https://github.com/photoprism/photoprism/labels/funded),
|
|
|
|
see [issuehunt.io](https://issuehunt.io/repos/119160553) for details.
|
|
|
|
Note that issue descriptions may be outdated on their site. Rewards are paid out when
|
|
|
|
all [acceptance criteria](https://github.com/photoprism/photoprism/wiki/Issues#user-stories) prioritized as
|
|
|
|
MUST are met and your [pull request](https://github.com/photoprism/photoprism/wiki/Pull-Requests)
|
|
|
|
was successfully merged.
|
2018-12-20 16:02:22 +01:00
|
|
|
|
2019-12-30 20:10:45 +01:00
|
|
|
Please follow us on [Twitter][twitter] and join our [developers mailing list](https://groups.google.com/a/photoprism.org/forum/#!forum/developers)
|
2018-11-23 11:44:23 +01:00
|
|
|
to receive regular project updates and discuss development related topics. Don't be afraid to ask stupid questions.
|
2018-10-05 16:31:57 +02:00
|
|
|
|
2019-01-09 06:38:56 +01:00
|
|
|
## Donations ##
|
2018-10-05 19:21:31 +02:00
|
|
|
|
2019-12-11 19:34:52 +01:00
|
|
|
PhotoPrism is a non-profit project run entirely by volunteers. We need your funds to pay for
|
|
|
|
[organizing meetups](https://github.com/photoprism/photoprism/wiki/Meetups),
|
|
|
|
[running our servers](https://github.com/photoprism/photoprism/wiki/Infrastructure),
|
|
|
|
visiting conferences, buying test devices, offering rewards for contributions, and covering our cost of living.
|
|
|
|
|
2019-12-18 14:30:39 +01:00
|
|
|
You're most welcome to support us via [GitHub Sponsors](https://github.com/sponsors/lastzero),
|
|
|
|
especially if you need help with using our software. They will match every donation in the first year.
|
2019-12-30 13:03:34 +01:00
|
|
|
In addition, you can find us on [Patreon][patreon] and [PayPal][paypal].
|
2018-10-05 19:21:31 +02:00
|
|
|
|
2019-12-05 23:18:27 +01:00
|
|
|
Also please leave a star if you like this project, it provides enough motivation to keep going. Thank you very much! <3
|
|
|
|
|
2019-12-30 13:03:34 +01:00
|
|
|
Feature requests backed by sponsors are marked with a golden [sponsor][sponsored issues] label.
|
|
|
|
Let us know if we mistakenly label an idea as [unfunded][unfunded issues].
|
2019-01-09 06:38:56 +01:00
|
|
|
|
2019-12-16 12:59:03 +01:00
|
|
|
## Corporate Sponsorship ##
|
2018-10-10 03:36:02 +02:00
|
|
|
|
2019-12-30 13:03:34 +01:00
|
|
|
Please [reach out to us](mailto:hello@photoprism.org) if you work for an organization that
|
|
|
|
can [support our project](https://dl.photoprism.org/slides/PhotoPrism.pdf)
|
2018-12-21 09:11:39 +01:00
|
|
|
as we are looking for a way to continue doing this full-time.
|
2019-12-30 13:03:34 +01:00
|
|
|
We'll be happy to mention your contribution plus you'll get a direct line
|
|
|
|
to [our team](https://docs.photoprism.org/en/latest/team/) of top-class engineers and scientists.
|
2018-12-19 05:39:12 +01:00
|
|
|
|
2019-01-09 06:54:02 +01:00
|
|
|
See [SPONSORS.md](SPONSORS.md) for details.
|
2018-10-10 03:36:02 +02:00
|
|
|
|
2019-12-30 13:03:34 +01:00
|
|
|
[help]: https://groups.google.com/a/photoprism.org/forum/#!forum/help
|
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
|
2019-01-09 06:38:56 +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
|
|
|
|
[ci]: https://travis-ci.org/photoprism/photoprism
|
|
|
|
[docs]: https://docs.photoprism.org/en/latest/
|
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
|
2019-07-04 18:41:17 +02:00
|
|
|
[twitter]: https://twitter.com/browseyourlife
|
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
|