AI-Powered Photos App for the Decentralized Web
Go to file
2022-01-06 11:31:37 +01:00
.github Docs: Update URL 2021-12-12 20:48:05 +01:00
assets Docs: Include link to trademark guidelines in README and LICENSE files 2021-12-20 18:49:55 +01:00
cmd/photoprism Copyright: Update year in photoprism command 2022-01-03 13:48:33 +01:00
docker OIDC: Add Traefik, Keycloak and Rename Development Base Image #782 2022-01-06 11:31:37 +01:00
frontend Index: Improve indexing and unstacking of related files #1823 2022-01-05 16:37:19 +01:00
internal Index: Improve related filename photo match query #1823 2022-01-06 10:09:07 +01:00
pkg Copyright: Update year in source files and footer.vue 2022-01-03 13:46:52 +01:00
scripts OIDC: Add Traefik, Keycloak and Rename Development Base Image #782 2022-01-06 11:31:37 +01:00
.dockerignore Dev: Ignore .env files 2021-07-25 23:48:01 +02:00
.drone.yml CI: Move Docker scripts to /scripts/docker 2021-12-10 17:01:45 +01:00
.fossa.yml Fix permissions of .fossa.yml 2020-10-09 10:43:19 +02:00
.gitignore Docker: Upgrade MariaDB image from 10.5 to 10.6 2021-10-21 15:16:02 +02:00
CODE_OF_CONDUCT.md Docs: Add links to CODE_OF_CONDUCT.md 2021-12-29 01:56:37 +01:00
codecov.yml Codecov: Disable commit status on GitHub 2019-12-01 21:58:12 +01:00
CONTRIBUTING.md Docs: Update CONTRIBUTING.md and README.md 2021-12-25 20:56:40 +01:00
docker-compose.ci.yml OIDC: Add Traefik, Keycloak and Rename Development Base Image #782 2022-01-06 11:31:37 +01:00
docker-compose.latest.yml OIDC: Add Traefik, Keycloak and Rename Development Base Image #782 2022-01-06 11:31:37 +01:00
docker-compose.mariadb.yml OIDC: Add Traefik, Keycloak and Rename Development Base Image #782 2022-01-06 11:31:37 +01:00
docker-compose.postgres.yml Docs: Update URL 2021-12-12 20:14:07 +01:00
docker-compose.yml OIDC: Add Traefik, Keycloak and Rename Development Base Image #782 2022-01-06 11:31:37 +01:00
Dockerfile OIDC: Add Traefik, Keycloak and Rename Development Base Image #782 2022-01-06 11:31:37 +01:00
FUNDING.yml Remove PayPal link from FUNDING.yml 2022-01-02 10:46:03 +01:00
go.mod Search: Improve query string normalization and sanitation #1814 #1820 2021-12-16 15:26:54 +01:00
go.sum Search: Improve query string normalization and sanitation #1814 #1820 2021-12-16 15:26:54 +01:00
LICENSE Docs: Update trademark info 2021-12-25 20:01:34 +01:00
Makefile OIDC: Add Traefik, Keycloak and Rename Development Base Image #782 2022-01-06 11:31:37 +01:00
NOTICE Docs: Update license notice 2021-09-25 16:01:43 +02:00
README.md Docs: Update README.md 2021-12-31 13:11:10 +01:00
SECURITY.md Update SECURITY.md 2021-10-23 18:31:29 +02:00
SPONSORS.md Docs: Update SPONSORS.md 2022-01-02 10:01:43 +01:00

PhotoPrism: Browse Your Life in Pictures

License: AGPL GitHub contributors Documentation Community Chat GitHub Discussions Twitter Reddit

PhotoPrism® is an AI-powered app for browsing, organizing & sharing your photo collection. It makes use of the latest technologies to tag and find pictures automatically without getting in your way. You can run it at home, on a private server, or in the cloud.

To get a first impression, you're welcome to play with our public demo at demo.photoprism.app (also available in Deutsch, Français, and 汉语).

Feature Overview

Getting Started

Step-by-step installation instructions for our self-hosted community edition can be found on docs.photoprism.app - all you need is a Web browser and Docker to run the server. It is available for Mac, Linux, and Windows.

The stable version and development preview have been built into a single multi-arch image for 64-bit AMD, Intel, and ARM processors. That means, Raspberry Pi 3 / 4 owners can pull from the same repository, enjoy the exact same functionality, and can follow the regular installation instructions after going through a short list of requirements.

Existing users are advised to update their docker-compose.yml config based on our examples available at dl.photoprism.app/docker.

Back us on Patreon or GitHub Sponsors 🎄

Your continued support helps us provide regular updates and services like world maps. Sponsors get access to additional features, receive direct technical support via email, and can join our private chat room on matrix.org.

We currently have the following sponsorship options:

Also, please leave a star on GitHub if you like this project. It provides additional motivation to keep going.

Getting Support

Please read the Troubleshooting Guide before reporting problems. If this doesn't help, or you have other questions:

In addition, sponsors receive direct technical support via email.

We'll do our best to answer all your questions. In return, we ask you to back us on Patreon or GitHub Sponsors. Think of "free software" as in "free speech," not as in "free beer". Thank you! 💜

When reporting a problem, always include the version you are using and information about your environment such as browser, operating system, installed memory, and processor type.

Roadmap

Our vision is to provide the most user- and privacy-friendly solution to keep your pictures organized and accessible. The roadmap shows what tasks are in progress, what needs testing, and which features are going to be implemented next. Please give ideas you like a thumbs-up 👍 , so that we know what is most popular.

Ideas endorsed by silver, gold, and platinum sponsors receive a golden label and will be prioritized on the roadmap.

We have a zero bug policy and do our best to help users when they need support or have other questions. This comes at a price, as we can't give exact deadlines for new features.

Having said that, funding really has the highest impact. So users can do their part and become a sponsor to get their favorite features as soon as possible.

Questions?

Follow us on Twitter or join our Community Chat to get regular updates, connect with other users, and discuss your ideas. Our Code of Conduct explains the "dos and donts."

Contributions

We welcome contributions of any kind, including bug reports, testing, writing documentation, tutorials, blog posts, and pull requests.

The Developer Guide contains all information necessary to get you started. Issues labeled help wanted / easy can be good (first) contributions.

Because we want to create the best possible product for our users, we have a set of guidelines to ensure that all source code submissions are acceptable. They include step-by-step instructions for submitting new features, bug fixes, and documentation improvements.

Reviewing, testing and finally merging pull requests requires significant resources on our side. If it's not just a small fix, it can take several months.

PhotoPrism® Trademark

Our Trademark and Brand Guidelines, which may be updated from time to time, describe how our Brand Assets may be used. It is important to us that any permitted use of our Brand Assets is fair and meets the highest standards. To ensure this, we reserve the right to object to any use or misuse in any jurisdiction worldwide.