7.4 KiB
Every Contribution Makes a Difference
We welcome contributions of any kind, including blog posts, tutorials, testing, writing documentation, and pull requests. Our Developer Guide contains all the information necessary for you to get started.
Join the Community
Follow us on Mastodon, Bluesky, or join the Community Chat to get regular updates, connect with other users, and discuss your ideas. Our Code of Conduct explains the "dos and don’ts" when interacting with other community members.
As a contributor, you are also welcome to contact us directly if you have something on your mind that you don't want to discuss publicly. Please note, however, that due to the high volume of emails we receive, our team may be unable to get back to you immediately. We do our best to respond within five business days or less.
Not a Developer? No Problem
You can also contribute by…
- answering questions in the Community Chat, on Reddit and in GitHub Discussions
- helping us translate the Web UI on Weblate
- conducting research and improving the documentation
- publishing tutorials, blog posts, and podcasts
- voting for us on pages like:
- recommending PhotoPrism to your friends
Creating Bug Reports
Before reporting a bug, please use our Troubleshooting Checklists to determine the cause of your problem. If you have a general question, need help, or an issue has not (yet) been clearly identified:
- You are welcome to ask in our Community Chat
- or post your question in GitHub Discussions
GitHub Issues
We kindly ask you not to report bugs via GitHub Issues unless you are certain to have found a fully reproducible and previously unreported issue that must be fixed directly in our source code. Thank you for your careful consideration!
- When reporting a problem, always include the software versions you are using and other information about your environment such as browser, browser plugins, operating system, storage type, memory size, and processor
- Note that all issue subscribers receive an email notification from GitHub whenever a new comment is added, so these should only be used for sharing important information and not for discussions, questions or expressing personal opinions
- Contact us or a community member if you need help, it could be a local configuration problem, or a misunderstanding in how the software works
- This gives our team the opportunity to improve the docs and provide best-in-class support to you, instead of handling unclear/duplicate bug reports or triggering a flood of notifications by responding to comments
Submitting Pull Requests
Follow our step-by-step guide to learn how to submit new features, bug fixes, and documentation enhancements.
Pull requests solving "help wanted" issues are the easiest to merge and the most helpful to us, as they allow us to spend more time on core functionality and other issues that are difficult for external contributors to work on. If you are new to this project, anything labeled "easy" may be a good first contribution.
Be aware that reviewing, testing and finally merging pull requests requires significant resources on our side. It can therefore take several months if it is not just a small fix, especially if extensive testing is needed to prevent bugs from getting into our stable version.
Contributor License Agreement (CLA)
After you submit your first pull request, you will be asked to accept our Contributor License Agreement (CLA). Visit photoprism.app/cla and photoprism.app/oss/faq to learn more.
Thank You to All Current and Past Sponsors 💎
A big thank you to all of our sponsors, whose generous support has been and continues to be essential to the success of the project! 💜
Our project infrastructure is provided by the following companies:
- GitHub hosts our code repositories and also provides many other important services
- Docker approved us for their Open Source Program and hosts all of our app images
- Element develops and operates the infrastructure that our community chat is based on
- BrowserStack provides free access to their device and browser testing infrastructure
View Sponsors › View Credits ›
Privacy Notice
We operate a number of web services that help us develop and maintain our software in collaboration with the open source community, for example translate.photoprism.app.
Because many of these apps and tools were originally developed for internal use without a high level of privacy in mind, we ask that you do not enter personal information such as your real name or personal email address if you want it to remain private.
Personal details may otherwise show up in logs, source code, translation files, commit messages, and pull request comments.
PhotoPrism® is a registered trademark. By using the software and services we provide, you agree to our Terms of Service, Privacy Policy, and Code of Conduct. Docs are available under the CC BY-NC-SA 4.0 License; additional terms may apply.