photoprism/README.md
Michael Mayer a54cf323f3 Docs: Update README.md
Signed-off-by: Michael Mayer <michael@liquidbytes.net>
2020-01-04 08:02:20 +01:00

6.7 KiB

PhotoPrism: Browse your life in pictures

License: GPL Code Quality Build Status Documentation GitHub contributors Community Chat Twitter

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.

More screenshots: https://photoprism.org/#screenshots

What to expect

  • 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

For the early birds

You're welcome to play with our demo at demo.photoprism.org. Leave your email to get a release notification.

Step-by-step installation instructions can be found in our User Guide. Developers can skip this and move on to the Developer Guide.

All you need is a Web browser and Docker 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 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 or contact us via email.

Why this has to be free software

The development of every commercial product is focused on monetization. We've built similar apps more than once and every single time the constraints of working in a profit-oriented corporate environment were an impediment.

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. Go itself is a great example.

Our long-term goal is to become an open platform for machine learning research based on real-world photo collections.

How to contribute

We welcome contributions of any kind. If you have a bug or an idea, read our guide before opening an issue. Issues labeled help wanted / easy can be good (first) contributions.

You'll get a small reward for working on funded issues, see issuehunt.io for details. Note that issue descriptions may be outdated on their site. Rewards are paid out when all acceptance criteria prioritized as MUST are met and your pull request was successfully merged.

Please follow us on Twitter and join our developers mailing list to receive regular project updates and discuss development related topics. Don't be afraid to ask stupid questions.

Donations

PhotoPrism is a non-profit project run entirely by volunteers. We need your funds to pay for organizing meetups, running our servers, 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, 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 and PayPal. Our sponsors and contributors will get for free whatever we have to charge for a geodata, public events and maps subscription later.

Also please leave a star if you like this project, it provides enough motivation to keep going. Thank you very much! <3

Ideas backed by a sponsor are marked with a golden sponsor label. Let us know if we mistakenly label an idea as unfunded.

Public and corporate sponsorship

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 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".

If any of those organizations changes their mind, they are welcome to reach out to us.