What the developer wrote
Authored by odudex
docs: update Mac driver troubleshooting
What changed, and why it matters
This commit is a minor documentation update for Krux, a self-custody Bitcoin hardware wallet project. It updates the macOS troubleshooting instructions for users who have trouble flashing firmware due to missing CH34X USB drivers. There is no code change, no security fix, and no vulnerability introduced or patched.
No security action required. Treat as routine documentation maintenance.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The diff modifies docs/snippets/error-flashing-mac.en.txt, changing ‘CH341 USB driver’ to ‘CH34X USB driver’ and adding a note about approving the driver’s extension in macOS system settings. This is purely a user-facing documentation clarification. No source code, build scripts, cryptographic logic, or device communication code is affected.
Changed components
docs/snippets/error-flashing-mac.en.txtInspect captured patch +2 / −1
diff --git a/docs/snippets/error-flashing-mac.en.txt b/docs/snippets/error-flashing-mac.en.txt
index 05fce72..19cb809 100644
--- a/docs/snippets/error-flashing-mac.en.txt
+++ b/docs/snippets/error-flashing-mac.en.txt
@@ -1 +1,2 @@
-On macOS, you may also run into flashing errors. This often happens when the CH341 USB driver is missing, preventing proper communication with the device. To fix it, download and install the [CH341 driver](https://www.wch-ic.com/downloads/CH341SER_MAC_ZIP.html).
\ No newline at end of file
+On macOS, you may also run into flashing errors. This often happens when a proper CH34X USB driver is missing, preventing proper communication with the device. To fix it, download and install the [CH341 driver](https://www.wch-ic.com/downloads/CH341SER_MAC_ZIP.html).
+After installing, you may also need to approve driver's "extension" in macOS system settings, identified as CH34xVCPDriver.app
\ No newline at end of file
Why this scored 15/100
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.