2018-10-05 17:19:46 +00:00
|
|
|
PhotoPrism: Browse your life in pictures
|
2018-10-05 06:27:45 +00:00
|
|
|
========================================
|
2018-08-23 12:44:21 +00:00
|
|
|
|
2018-12-19 04:39:12 +00: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 02:05:51 +00:00
|
|
|
[![Build Status](https://travis-ci.org/photoprism/photoprism.png?branch=develop)][ci]
|
2018-10-08 17:01:41 +00:00
|
|
|
[![Documentation](https://readthedocs.org/projects/photoprism-docs/badge/?version=latest&style=flat)][docs]
|
2019-04-29 15:20:33 +00:00
|
|
|
[![GitHub contributors](https://img.shields.io/github/contributors/photoprism/photoprism.svg)](https://github.com/photoprism/photoprism/graphs/contributors/)
|
2019-01-09 05:03:03 +00:00
|
|
|
[![Community Chat](https://img.shields.io/badge/chat-on%20gitter-4aa087.svg)][chat]
|
2019-07-04 16:41:17 +00:00
|
|
|
[![Twitter](https://img.shields.io/badge/follow-@browseyourlife-00acee.svg)][twitter]
|
2018-02-27 18:46:50 +00:00
|
|
|
|
2018-10-13 15:40:57 +00: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.
|
2020-01-02 15:27:30 +00:00
|
|
|
Say goodbye to solutions that force you to upload your visual memories to the cloud.
|
2018-09-27 13:46:20 +00:00
|
|
|
|
2018-12-18 23:24:02 +00:00
|
|
|
![](https://dl.photoprism.org/assets/img/preview.jpg)
|
2018-09-26 13:35:34 +00:00
|
|
|
|
2018-10-07 13:05:17 +00:00
|
|
|
More screenshots: https://photoprism.org/#screenshots
|
|
|
|
|
2019-01-09 05:38:56 +00:00
|
|
|
## What to expect ##
|
2018-09-27 13:46:20 +00:00
|
|
|
|
2018-10-05 14:31:57 +00: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.
|
2018-09-27 20:40:38 +00:00
|
|
|
|
2019-01-09 05:38:56 +00:00
|
|
|
## For the early birds ##
|
2018-10-07 13:47:56 +00:00
|
|
|
|
2018-12-16 13:04:54 +00: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 15:32:24 +00:00
|
|
|
|
2018-12-16 13:04:54 +00:00
|
|
|
Step-by-step [installation instructions](https://docs.photoprism.org/en/latest/setup/) can be found
|
2018-10-13 17:24:05 +00:00
|
|
|
in our [User Guide](https://docs.photoprism.org/en/latest/).
|
2018-10-09 20:51:58 +00:00
|
|
|
Developers can skip this and move on to the [Developer Guide](https://github.com/photoprism/photoprism/wiki).
|
2018-10-07 13:47:56 +00:00
|
|
|
|
2018-10-13 17:54:29 +00: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 11:59:03 +00: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 19:42:04 +00:00
|
|
|
|
2019-12-30 12:03:34 +00:00
|
|
|
If you have a question, don't hesitate to ask in our [help forum][help]
|
2018-11-22 20:20:55 +00:00
|
|
|
or [contact us via email](mailto:hello@photoprism.org).
|
2018-10-13 17:54:29 +00:00
|
|
|
|
2019-01-09 05:38:56 +00:00
|
|
|
## Why this has to be free software ##
|
2018-10-07 13:47:56 +00:00
|
|
|
|
2018-10-13 15:28:53 +00:00
|
|
|
The development of every commercial product is focused on monetization.
|
2019-12-30 12:03:34 +00: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 15:28:53 +00:00
|
|
|
in a profit-oriented corporate environment were an impediment.
|
2018-12-16 14:13:52 +00:00
|
|
|
|
2019-12-30 12:03:34 +00: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 19:55:48 +00:00
|
|
|
Go itself is a [great example](https://talks.golang.org/2015/simplicity-is-complicated.slide).
|
2018-10-07 13:47:56 +00:00
|
|
|
|
2019-12-30 12:03:34 +00: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 14:37:46 +00:00
|
|
|
|
2019-01-09 05:38:56 +00:00
|
|
|
## How to contribute ##
|
2018-10-05 14:31:57 +00:00
|
|
|
|
2018-10-13 15:38:02 +00: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 19:02:24 +00: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 15:02:22 +00:00
|
|
|
good (first) contributions.
|
|
|
|
|
2019-12-30 12:03:34 +00: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 15:02:22 +00:00
|
|
|
|
2019-12-30 19:10:45 +00: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 10:44:23 +00:00
|
|
|
to receive regular project updates and discuss development related topics. Don't be afraid to ask stupid questions.
|
2018-10-05 14:31:57 +00:00
|
|
|
|
2019-01-09 05:38:56 +00:00
|
|
|
## Donations ##
|
2018-10-05 17:21:31 +00:00
|
|
|
|
2019-12-11 18:34:52 +00: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 13:30:39 +00: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.
|
2020-01-02 15:27:06 +00:00
|
|
|
In addition, you can find us on [Patreon][patreon] and [PayPal][paypal].
|
|
|
|
Our sponsors and contributors will get for free whatever we have to charge for a geodata,
|
|
|
|
public events and maps subscription later.
|
2018-10-05 17:21:31 +00:00
|
|
|
|
2019-12-05 22:18:27 +00:00
|
|
|
Also please leave a star if you like this project, it provides enough motivation to keep going. Thank you very much! <3
|
|
|
|
|
2020-01-02 12:33:01 +00:00
|
|
|
Ideas backed by a sponsor are marked with a golden [sponsor][sponsored issues] label.
|
2019-12-30 12:03:34 +00:00
|
|
|
Let us know if we mistakenly label an idea as [unfunded][unfunded issues].
|
2019-01-09 05:38:56 +00:00
|
|
|
|
2020-01-02 13:15:11 +00:00
|
|
|
## Public and corporate sponsorship ##
|
2018-10-10 01:36:02 +00:00
|
|
|
|
2020-01-02 12:11:01 +00:00
|
|
|
Our software is now almost done after two years of hard work, some days 16 to 20 hours on top of other projects we
|
|
|
|
did to finance this. We spent weeks asking organizations like [The Prototype Fund](https://prototypefund.de/en/)
|
|
|
|
for help and also tried to cooperate with companies like Mapbox and Cewe. We have been ignored and even given
|
|
|
|
the advice that what we do "already exists in America".
|
2018-12-19 04:39:12 +00:00
|
|
|
|
2020-01-02 12:11:01 +00:00
|
|
|
If any of those organizations changes their mind, they are welcome to [reach out to us](mailto:hello@photoprism.org).
|
2018-10-10 01:36:02 +00:00
|
|
|
|
2019-12-30 12:03:34 +00:00
|
|
|
[help]: https://groups.google.com/a/photoprism.org/forum/#!forum/help
|
2018-11-19 03:24:43 +00:00
|
|
|
[license]: https://github.com/photoprism/photoprism/blob/develop/LICENSE
|
2019-12-30 12:03:34 +00:00
|
|
|
[patreon]: https://www.patreon.com/photoprism
|
2019-01-09 05:38:56 +00:00
|
|
|
[paypal]: https://www.paypal.me/photoprism
|
2018-11-20 08:23:45 +00:00
|
|
|
[goreport]: https://goreportcard.com/report/github.com/photoprism/photoprism
|
2018-11-19 03:24:43 +00: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 18:35:52 +00:00
|
|
|
[issuehunt]: https://issuehunt.io/repos/119160553
|
2019-01-09 05:03:03 +00:00
|
|
|
[chat]: https://gitter.im/browseyourlife/community
|
2019-07-04 16:41:17 +00:00
|
|
|
[twitter]: https://twitter.com/browseyourlife
|
2019-12-30 12:03:34 +00: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
|