Contributing

Report a bug or share model details

You can help without writing code.

Report a bug

Use the OpenBlade issue tracker for crashes, missing controls, incorrect readings, or profile problems.

What happened

  • What you were trying to do
  • What you expected and what happened instead
  • Steps to reproduce the problem
  • Any message shown by OpenBlade

Your laptop

  • Your OpenBlade version
  • The Blade name and model number
  • Your BIOS, EC, and MCU versions
  • Whether Synapse or another hardware utility was running

Report a bug on GitHub

Review files before sharing Screenshots and OpenBlade's redacted diagnostic export can help. Remove account details, serial numbers, user names, and local paths. Never attach a raw USB capture to a public issue.

Help support another Blade model

If your model is missing from the Compatibility page, open an issue with the details below. A maintainer will tell you whether a diagnostic export, screenshot, or capture is needed.

Identify the model

  • The full product name and model number, such as RZ09-xxxx
  • The BIOS, EC, and MCU versions
  • The hardware ID, if you already know it

Show what it can do

  • The controls available in Synapse
  • The features you want OpenBlade to support
  • Screenshots with personal information removed

Request support for a modelHow model support works

About captures

A capture can show how one control works, but it may contain device data. Read Safe testing and speak with a maintainer before collecting or publishing one.

Other contributions

Report documentation mistakes in the documentation repository. The core repository contains development and build instructions.

For a security problem or anything that may expose sensitive device data, do not open a public issue. Follow the project's security policy.