Contributing and Reporting Bugs

If you would like to contribute financial support to the project, the best way to proceed is to purchase an annual license for one of the WhiteboxTools Extension products. The proceeds from the extensions go towards paying developers who work on the open-core portion of the WhiteboxTools platform. Each license sale goes a long way towards making the ongoing development of WhiteboxTools more sustainable.

If you would like to contribute to the project as a developer, follow these instructions to get started:

  1. Fork the WhiteboxTools project ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Unless explicitly stated otherwise, any contribution intentionally submitted for inclusion in the work shall be licensed under the MIT License without any additional terms or conditions.

We also welcome contributions in the form of media exposure. If you have written an article or blog about WhiteboxTools please let us know about it (

WhiteboxTools is distributed as is and without warranty of suitability for application. If you encounter flaws with the software (i.e. bugs) please report the issue. Providing a detailed description of the conditions under which the bug occurred will help to identify the bug. Use the Issues tracker on GitHub to report issues with the software and to request feature enchancements. Please do not email Dr. Lindsay directly with bugs.


The following is a list of the developers who have helped to improve WhiteboxTools by contributing code.

  1. John Lindsay (jblindsay)
  2. Dharhas Pothina (dharhas)
  3. Qiusheng Wu (giswqs)
  4. Daniel Newman
  5. Anthony Francioni (Afrancioni)
  6. Simon Gudim
  7. Alexander Bruy (alexbruy)
  8. Katrin Leinweber (katrinleinweber)
  9. Yvan Le Bras (yvanlebras)

If you feel you're missing from this list, please let us know. Also, the project is grateful to the numerous users that have contributed bug reports that have resulted in improvements to individual tools.