Contributing and Reporting Bugs

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.

If you would like to contribute financial support for the project, please contact John Lindsay. 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.