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
2020-06-15 09:49:06 +02:00
[][license]
2018-12-19 05:39:12 +01:00
[][goreport]
2018-10-31 03:05:51 +01:00
[][ci]
2019-04-29 17:20:33 +02:00
[](https://github.com/photoprism/photoprism/graphs/contributors/)
2020-06-07 13:26:13 +02:00
[][docs]
2019-01-09 06:03:03 +01:00
[][chat]
2019-07-04 18:41:17 +02:00
[][twitter]
2018-02-27 19:46:50 +01:00
2020-05-21 10:03:56 +02:00
PhotoPrism™ is a server-based application for browsing, organizing and sharing your personal photo collection.
2018-10-13 17:40:57 +02:00
It makes use of the latest technologies to automatically tag and find pictures without getting in your way.
2020-06-22 15:35:57 +02:00
Say goodbye to solutions that force you to upload your visual memories to the public cloud.
2018-09-27 15:46:20 +02:00
2018-12-19 00:24:02 +01:00
2018-09-26 15:35:34 +02:00
2020-01-24 04:07:58 +01:00
More screenshots: https://github.com/photoprism/photoprism/wiki/Screenshots
2018-10-07 15:05:17 +02:00
2019-01-09 06:38:56 +01:00
## What to expect ##
2018-09-27 15:46:20 +02:00
2020-01-24 04:09:02 +01:00
* Clearly structured Web interface for browsing, organizing and sharing your personal photo collection
2020-01-15 14:45:49 +01:00
* Import everything without worrying about duplicates or [RAW to JPEG conversion][wiki:raw]
2020-01-31 17:29:55 +01:00
* [Geocoding][wiki:geocoding], [XMP support][wiki:xmp] and [automated tagging][wiki:classification]
2020-01-14 00:31:16 +01:00
based on Google TensorFlow
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
2020-06-07 13:14:20 +02:00
Step-by-step [installation instructions ](https://docs.photoprism.org/getting-started/ ) can be found
in our [User Guide ](https://docs.photoprism.org/ ).
Developers can skip this and move on to the [Developer Guide ](https://docs.photoprism.org/developer-guide/ ).
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
2020-02-18 10:59:13 +01:00
There is also a [pre-installed Raspberry Pi image here ](https://github.com/guysoft/PhotoPrismPi ).
2020-01-08 12:40:20 +01:00
Note that this is work in progress. We do our best to provide a complete, stable version.
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.
2020-01-09 23:57:55 +01:00
We're already in contact with data scientists who like our idea.
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
2020-06-07 13:14:20 +02:00
[guide ](https://docs.photoprism.org/developer-guide/ ) 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 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
2020-01-09 16:11:40 +01:00
## Free beer ##
2020-01-04 20:19:50 +01:00
2020-01-26 10:56:22 +01:00
This project is about freedom and privacy but not necessarily about free beer. We feel like it
would be a mistake to state there will be no costs, because clearly we have huge expenses, your server hardware
2020-01-09 23:57:55 +01:00
will have a price tag and then maybe you'd like to have some extra features that need to be developed.
2020-01-04 20:19:50 +01:00
2020-01-26 11:07:52 +01:00
It's fair to say that users with basic needs will have no monthly costs. We were also way more effective
per dollar than commercial projects and learned a lot on top of it.
2020-01-09 23:57:55 +01:00
An earlier version of this document contained a rough number, but at the end of the day it doesn't matter.
2020-01-04 20:19:50 +01:00
2020-06-22 15:35:57 +02:00
Most established OSS companies make the bulk of their revenue with enterprise customers, that's why private users
2020-01-09 23:57:55 +01:00
and single developers typically get everything for free. Obviously that doesn't work if you have only private users
2020-06-22 15:49:19 +02:00
that refuse to share their data on top of it.
2020-01-09 13:23:31 +01:00
2020-01-09 23:57:55 +01:00
Looking forward, specific solutions for funding development and maintenance could be to...
2020-01-04 20:19:50 +01:00
2020-01-04 22:03:10 +01:00
- sell a tested & supported version in the app store while our contributors and other developers can
2020-01-04 20:19:50 +01:00
continue to use Docker or build from source
2020-06-22 15:35:57 +02:00
- provide additional features to users who support us financially, maybe with a different license similar to GitLab
- develop a one-click solution for private cloud hosting together with selected providers we trust
2020-01-09 03:55:14 +01:00
- offer a geodata, public events and maps subscription since OpenStreetMap doesn't want us to use their development
2020-01-09 13:23:31 +01:00
API for production, which is perfectly fine
2020-01-04 20:19:50 +01:00
## Donations ##
2019-12-11 19:34:52 +01:00
2020-06-09 11:25:33 +02:00
You're welcome to support us via [GitHub Sponsors ](https://github.com/sponsors/lastzero ),
especially if you have feature requests or need help with using our software.
They will match every donation in the first year.
2020-01-09 03:55:14 +01:00
In addition, you can find us on [Patreon ](https://www.patreon.com/photoprism ) and [PayPal ](https://www.paypal.me/photoprism ).
Our [sponsors ](https://github.com/photoprism/photoprism/blob/develop/SPONSORS.md ) and
[contributors ](https://github.com/photoprism/photoprism/graphs/contributors/ ) will get for free whatever we might
2020-06-22 15:35:57 +02:00
have to charge for a geodata subscription and/or additional features later (see [tiers ](https://github.com/sponsors/lastzero/dashboard/tiers )).
2018-10-05 19:21:31 +02:00
2020-06-15 14:40:46 +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.
2019-12-05 23:18:27 +01:00
2020-01-09 03:55:14 +01:00
Ideas backed by a sponsor are marked with a golden [sponsor ](https://github.com/photoprism/photoprism/issues?q=is%3Aissue+is%3Aopen+label%3Asponsor ) label.
Let us know if we mistakenly label an idea as [unfunded ](https://github.com/photoprism/photoprism/issues?q=is%3Aissue+is%3Aopen+label%3Aunfunded ).
2019-01-09 06:38:56 +01:00
2020-01-04 20:29:08 +01:00
Thank you very much! < 3
2020-01-09 05:26:19 +01:00
## Disclaimer ##
2020-03-06 14:30:04 +01:00
We'd like to remind everyone that we are not full-time marketing specialists but developers who work a lot and
2020-05-21 17:44:28 +02:00
enjoy a bit of sarcasm from time to time. Please let us know when there is an issue with our "nuance and tone",
2020-01-09 05:26:19 +01:00
and we'll find a solution.
2020-06-22 15:35:57 +02:00
PhotoPrism™ is a registered trademark of Michael Mayer.
2020-05-23 09:49:26 +02:00
You may use it as required to describe our software, run your own server, for educational purposes,
2020-06-15 14:40:46 +02:00
but not for offering commercial goods, products, or services without prior written permission.
2020-05-24 12:59:07 +02:00
In other words, please ask.
2020-05-21 10:03:56 +02:00
2020-01-14 00:31:16 +01:00
[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
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
2020-06-07 13:14:20 +02:00
[docs]: https://docs.photoprism.org/
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
