Contributing

HandBrake is an open source project created and maintained by the HandBrake Team. All are welcome to contribute to the project, and contributions following these simple guidelines are more likely to be accepted.

Conduct

First and foremost, familiarize yourself with the project’s Code of Conduct and Community Forum Rules. The HandBrake Team expects all contributors to conduct themselves accordingly.

Communication

Please ask the HandBrake Team via one of the Community Support channels before adding major features or making other broad changes.

Failure to communicate what you are working on may lead to duplicated efforts or rejection of your contributions.

Ways to contribute

User interface and graphics

HandBrake’s user interface is constantly evolving. Special care and expertise are required to enhance usability while retaining and expanding its many professional features. Icons and other graphic assets are also needed from time to time, as user interface updates and modernization dictate.

The HandBrake Team welcomes contributions from user interface and graphic designers. Please introduce yourself via one of the Community Support channels and someone will be glad to discuss what others are currently working on, your interests, and how you can help.

Code

Developers wanting to contribute code should check out the HandBrake source code on GitHub and create a pull request on GitHub for each contribution. For more on this workflow, read Understanding the GitHub Flow.

Open issues are good candidates for learning and fixing various parts of the code base.

Documentation

HandBrake Documentation is published on the official HandBrake website, and the documentation source is hosted on GitHub.

Please read the documentation project’s Contributing guide to get started.

Translation

HandBrake is written and maintained in English, and translated into multiple international languages by a community of volunteers. The HandBrake Team is working on bringing full technical support for multiple languages to all supported platforms; in the meantime, you will likely find translations available for some platforms and not others.

To view and contribute translations of the user interface strings in HandBrake, visit HandBrake on Transifex.

If you would like to contribute a translation of the HandBrake Documentation, please base it on the English documentation and submit a pull request to HandBrake Documentation on GitHub.