Every Contribution Makes a Difference¶
We welcome contributions of any kind, including blog posts, tutorials, testing, writing documentation, and pull requests.
Upcoming Features and Enhancements¶
The public roadmap shows what tasks are in progress, what needs testing, and which features are going to be implemented next.
Join the Community¶
An important part of our journey is to explore new directions in product development and build better software through consistent use of feedback.
Feel free to contact us with anything that is on your mind, even if you just want to say hello. It is our goal to answer all questions we receive from our users, customers, partners, and the developer community. Our team also welcomes feedback if you believe something can or should be improved.
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, it could be a local configuration issue, or a misunderstanding in how the software works:
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.
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 the app.
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.
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.
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
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.