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.
- Change only one reversible setting at a time.
- Record the value before the change so it can be restored.
- Keep the original capture private. Share only the reviewed, sanitized result through the path a maintainer provides.
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.