Back to top

Contribute to LibreTime

LibreTime is a fork of AirTime due to stalled development of the open source version. For background on this, see this open letter to the Airtime community.

Code of conduct

Before any contribution, read and be prepared to adhere to our code of conduct.

In addition, LibreTime follow the standardized C4 development process, in which you can find explanation about most of the development workflows for LibreTime.

Bug reporting

Following these guidelines helps maintainers and the community understand your report, reproduce the behavior, and find related reports.

Before creating bug reports, please check the following list, to be sure that you need to create one:

Note: If you find a Closed issue that seems like it is the same thing that you’re experiencing, open a new issue and include a link to the original issue in the body of your new one.

When you are creating a bug report, please include as many details as possible. Fill out the required template, the information it asks helps the maintainers resolve the issue faster.

Bugs are tracked on the official issue tracker.

Suggesting enhancements

This section guides you through submitting an enhancement suggestion for LibreTime, including completely new features and minor improvements to existing functionality. Following these guidelines helps maintainers and the community understand your suggestion and find related suggestions.

Before creating enhancement suggestions, please check the following list, as you might find out that you don’t need to create one:

When you are creating an enhancement suggestion, please include as many details as possible. Fill in the template, including the steps that you imagine you would take if the feature you’re requesting existed.

Financial

LibreTime is run by volunteers who write code and manage the project in their spare time. Financial contributions help us pay for our domain and back-end 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.

Translation

LibreTime can run in over 15 different languages due to the gracious help of our volunteers. Is your language not supported? Follow this guide to add your language to LibreTime!

Write documentation

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.

Our site is built by Jekyll, which has an installation guide here to help get you started. After cloning our repo locally, enter the docs/ directory and run

bundle install
jekyll serve