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]
|
|
|
|
|
[][goreport]
|
2018-10-31 03:05:51 +01:00
|
|
|
[][ci]
|
2018-10-08 19:01:41 +02:00
|
|
|
[][docs]
|
2019-04-29 17:20:33 +02:00
|
|
|
[](https://github.com/photoprism/photoprism/graphs/contributors/)
|
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
|
|
|
|
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.
|
2020-01-02 16:27:30 +01:00
|
|
|
Say goodbye to solutions that force you to upload your visual memories to the 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
|
|
|
|
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
|
|
|
|
2020-01-04 08:02:20 +01: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
|
2020-01-05 21:20:01 +01:00
|
|
|
* Reverse geocoding, XMP support and automated tagging 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
|
|
|
|
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.
|
2020-01-05 12:38:56 +01:00
|
|
|
[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
|
|
|
|
2020-01-04 20:19:50 +01:00
|
|
|
## Funding ##
|
|
|
|
|
|
|
|
|
|
It's clear many users are waiting for a stable release while only very few donate or help with development.
|
|
|
|
|
This project is about freedom but not necessarily about free beer.
|
|
|
|
|
|
|
|
|
|
We are not Google and don't have billions of dollars on our bank accounts to give away to our fans in exchange for their data.
|
|
|
|
|
It's also somewhat disappointing how little support we get by companies and especially public organizations.
|
|
|
|
|
Not a single dollar.
|
|
|
|
|
|
|
|
|
|
Every politician wants to support Open Source and warns social media is bad for your privacy, but only very
|
|
|
|
|
few are willing to help those that actually do something.
|
2018-10-05 19:21:31 +02:00
|
|
|
|
2020-01-04 20:19:50 +01:00
|
|
|
The consequence is that we are forced to think about monetization. We honestly didn't expect this will be an issue
|
|
|
|
|
and didn't ask for anything the first year. Thank you very much to our few sponsors!
|
|
|
|
|
We still love each and everyone of you, even those that send multiple pages of written requirements and then ask
|
|
|
|
|
every week when it is done.
|
|
|
|
|
|
|
|
|
|
Specific solutions could be to...
|
|
|
|
|
|
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
|
|
|
|
|
- offer a geodata, public events and maps subscription since OpenStreetMap doesn't want us to use
|
|
|
|
|
their development API for production
|
|
|
|
|
|
|
|
|
|
## Donations ##
|
2019-12-11 19:34:52 +01:00
|
|
|
|
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.
|
2020-01-02 16:27:06 +01:00
|
|
|
In addition, you can find us on [Patreon][patreon] and [PayPal][paypal].
|
2020-01-04 20:19:50 +01:00
|
|
|
Our sponsors and contributors will get for free whatever we might have to charge for a geodata subscription later.
|
2018-10-05 19:21:31 +02:00
|
|
|
|
2020-01-05 12:38:56 +01:00
|
|
|
Also please [leave a star](https://github.com/photoprism/photoprism/stargazers) here on GitHub if you like this project,
|
2020-01-04 20:29:08 +01:00
|
|
|
it provides additional motivation to keep going.
|
2019-12-05 23:18:27 +01:00
|
|
|
|
2020-01-08 12:26:52 +01:00
|
|
|
Financial support makes a huge difference and enables us to spend more time with the features you care about.
|
2020-01-02 13:33:01 +01:00
|
|
|
Ideas backed by a sponsor are marked with a golden [sponsor][sponsored issues] label.
|
2019-12-30 13:03:34 +01:00
|
|
|
Let us know if we mistakenly label an idea as [unfunded][unfunded issues].
|
2019-01-09 06:38:56 +01:00
|
|
|
|
2020-01-04 20:29:08 +01:00
|
|
|
Thank you very much! <3
|
|
|
|
|
|
2020-01-08 11:03:46 +01:00
|
|
|
## Lessons learned ##
|
|
|
|
|
|
|
|
|
|
Having done mostly commercial projects in the last 10+ years, it is important for us to explore various forms of funding
|
|
|
|
|
and communication for independent Open Source projects. Note that many of today's popular projects are funded by
|
2020-01-08 12:26:52 +01:00
|
|
|
corporations like Google, Facebook, Microsoft or Intel.
|
|
|
|
|
|
|
|
|
|
That's a good thing and we profit from it, but doesn't mean independent developers should not do this full-time or pay
|
|
|
|
|
everything themselves without asking the community for support. In fact, crowdfunding is a pretty common way to cover
|
|
|
|
|
development expenses if you look at [Indiegogo](https://www.indiegogo.com/) or [Kickstarter](https://www.kickstarter.com/).
|
2020-01-08 11:03:46 +01:00
|
|
|
|
|
|
|
|
In no way do we spurn other OSS projects like [OpenStreetMap](https://www.openstreetmap.org/),
|
|
|
|
|
as a Twitter user suggested. We just state the fact that even a non-commercial app can't use their API
|
2020-01-08 12:26:52 +01:00
|
|
|
for production, which is perfectly OK.
|
|
|
|
|
|
2020-01-08 11:03:46 +01:00
|
|
|
On the other hand, it also doesn't mean we have to provide this service for free to our users.
|
|
|
|
|
We've learned that money is a very sensitive topic most of our users don't engage with and even try to avoid.
|
2020-01-08 11:10:48 +01:00
|
|
|
No wonder many founders go the easy way, take venture capital and sell licenses for their software.
|
2020-01-08 11:03:46 +01:00
|
|
|
|
2020-01-02 14:15:11 +01:00
|
|
|
## Public and corporate sponsorship ##
|
2018-10-10 03:36:02 +02:00
|
|
|
|
2020-01-02 13:11:01 +01: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 05:39:12 +01:00
|
|
|
|
2020-01-02 13:11:01 +01:00
|
|
|
If any of those organizations changes their mind, they are welcome to [reach out to us](mailto:hello@photoprism.org).
|
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
|
