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
Contributing
Report a bug or share model details
You can help without writing code.
Report a bug
Report crashes, missing controls, incorrect readings, and profile problems in the OpenBlade issue tracker.
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
Review files before sharing
Screenshots and OpenBlade's redacted diagnostic export can help. Remove account details, serial numbers, user names, and local paths. Do not attach a raw USB capture to a public issue.
Test an experimental model
The experimental support guide lists five exact models, available controls, and how to export before/after diagnostics. Record one change, its visible result, and the return to the starting setting. Share reviewed reports in the existing experimental support issue. OpenBlade saves exports locally; you choose whether to share them.
Help support another Blade model
If your model is missing from the Compatibility page, collect its details with Synapse Observer, review the saved ZIP, and open a device-support request. An information-only ZIP is useful even when recording is unavailable.
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 modelDownload Synapse ObserverHow model support works
About captures
Use Synapse Observer first. It saves a reviewable evidence ZIP locally and guides the change and restoration. Collect a raw packet capture only when a maintainer identifies a specific remaining question. Read Safe testing before starting.
- 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.
Report Synapse Observer bugs and recording problems in the Observer issue tracker. Keep OpenBlade behavior and model-support requests in the core issue tracker.
Other contributions
For documentation edits, follow the repository-wide language guidelines: write directly, keep overviews brief, and link to technical detail.
Report documentation mistakes in the documentation repository. The core repository contains development and build instructions.
Report security problems and possible exposure of sensitive device data through the project's security policy, not a public issue.