photoprism/README.md

116 lines
6.6 KiB
Markdown
Raw Normal View History

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]
[![Build Status](https://travis-ci.org/photoprism/photoprism.png?branch=develop)][ci]
[![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/)
[![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)
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-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-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.
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.
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-13 17:28:53 +02:00
The development of every commercial product is focused on monetization.
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
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).
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.
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.
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
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
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.
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.
In addition, you can find us on [Patreon][patreon] and [PayPal][paypal].
2018-10-05 19:21:31 +02:00
Also please leave a star if you like this project, it provides enough motivation to keep going. Thank you very much! <3
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
## Corporate Sponsorship ##
2018-10-10 03:36:02 +02: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.
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
[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
[patreon]: https://www.patreon.com/photoprism
2019-01-09 06:38:56 +01:00
[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://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
[chat]: https://gitter.im/browseyourlife/community
2019-07-04 18:41:17 +02:00
[twitter]: https://twitter.com/browseyourlife
[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