Contributing to LibreTime
First and foremost, thank you! We appreciate that you want to contribute to LibreTime, your time is valuable, and your contributions mean a lot to us.
Before any contribution, read and be prepared to adhere to our code of conduct.
LibreTime development workflows follow the standardized C4 development process, with some LibreTime specific changes:
- 2.3. Patch Requirements
7.A patch commit message MUST follow the conventional commits specification.
- 2.4. Development Process
16.Maintainers MAY NOT merge incorrect patches.
- 2.5. Branches and Releases
1.The project SHALL have a development branch (
main) that always holds the latest in-progress version and SHOULD always build. The project MAY have a bug fixes only branch (
stable) that always holds the current stable version and SHOULD always build.
3.To make a stable release a Maintainer shall tag the repository. Stable releases SHALL always be released from the repository
LibreTime is run by volunteers who manage the project in their spare time. Financial contributions help us pay for our domain and infrastructure. It can also be used to cover the costs of development for important features and conference attendance. If you wish to contribute financially, you can do so through our OpenCollective.
One of the simplest ways to get started contributing to a project is through improving documentation. LibreTime is constantly evolving, this means that sometimes our documentation has gaps. You can help by adding missing sections, editing the existing content so it is more accessible or creating new content (tutorials, FAQs, etc).
Issues pertaining to the documentation are usually marked with the documentation label.
LibreTime can run in over 15 different languages due to the gracious help of our volunteers.
LibreTime is localized using Weblate. If you would like to contribute a language translation, create an account and start working on our Weblate page.
Report bugs or request features
Help us improve LibreTime by submitting a bug report or suggesting new features. When you are creating a report, please include as many details as possible.
You will find more details on how to submit a report on the issue creation page.
The official issue tracker is hosted on Github.
Contribute with code
Are you familiar with coding in PHP or Python? Have you made projects in Liquidsoap and some of the other services we use? Help us improve LibreTime by picking an issue in the list of bugs and feature requests.
Then fork our repo and setup a development environment to get you started! Make sure to setup pre-commit to enforce the project best practices before committing new code.
Knowledge on how to use Github and Git will suit you well, use the links for a quick 101.