docs: TC-code - warn about privacy when filling flash with entropy from camera
What changed, and why it matters
This commit does not fix a software bug. It adds documentation warnings and an on-screen reminder telling users to read the docs before using the TC Code tamper-detection feature. The underlying behavior being warned about is that Krux can fill spare flash memory with raw camera frames to make tamper checking easier; because those frames are stored unscrambled, someone who later dumps the device's flash could reconstruct the captured images. The commit itself only changes text and translations, not the storage behavior.
Users enabling TC Code should follow the new guidance: frame only well-lit, visually rich but harmless surfaces (fabric, gravel, foliage) and avoid faces, documents, screens, seed backups, addresses, or recognizable surroundings. Developers should consider whether future releases should scramble or encrypt camera-derived flash filler, or offer an alternative entropy source, to remove the privacy risk rather than only documenting it.
Security signals we found
Privacy warning added for unscrambled camera frames stored in flash
On-device prompt added to read documentation before TC Code setup
No cryptographic or storage-behavior change in the diff
Evidence from the diff
The patch is purely documentation/UI: it adds a privacy warning to docs/getting-started/features/tamper-detection.en.md explaining that camera entropy used to fill flash blocks is stored without scrambling, so a flash dump can reconstruct the images. It also adds a translated prompt ‘Read the documentation before proceeding’ to the TC Code setup screen in settings_page.py. No code that writes, encrypts, scrambles, or otherwise handles flash/camera data is modified. The security-relevant behavior (unscrambled camera frames in flash) existed before this commit and is only being disclosed to users here.
Changed components
docs/getting-started/features/tamper-detection.en.mdsrc/krux/pages/settings_page.pyi18n translation filessrc/krux/translations modulesInspect captured patch +33 / −2
### docs/getting-started/features/tamper-detection.en.md
@@ -33,6 +33,8 @@ When you enable the *TC Flash Hash at Boot* feature, the device will require you
*TC Flash Hash* produces a unique visual and verbal signature (an image and two sets of words) that helps you instantly recognize unauthorized changes. See below for details on how it works and what to expect from its output.
+**Privacy warning**: Right after the *TC Code* is set, Krux offers to fill the empty blocks of the flash memory with entropy captured from the camera. Camera frames are stored as they are captured, without scrambling, so that what gets written to the flash stays verifiable. As a consequence, anyone who later dumps the device's flash memory can reconstruct the captured images. Frame something well-lit, visually rich but harmless, such as fabric, a textured surface, gravel or foliage, and keep faces, documents, screens, seed backups, addresses and any recognizable feature of your home or surroundings out of the shot.
+
### How Krux Tamper Detection Works
## Tamper Check Code (TC Code)
@@ -68,6 +70,8 @@ Any change in the flash content results in a different image and words:
Use this to enhance tamper detection. Krux performs a memory sweep while capturing a live feed from the camera. Whenever an empty block is found in the flash memory, it uses the data from the image to fill these empty spaces when the entropy is good enough. It estimates the image's entropy by evaluating its color variance waiting until a minimum threshold is met.
+Because the captured frames are written to the flash unmodified, so that the stored content remains verifiable, avoid framing anything that could compromise your privacy. See the privacy warning in [Setting Up Tamper Detection](#setting-up-tamper-detection).
+
A progress bar is shown below, when the highlighted color appears, it means that this flash memory space is not empty and Krux will move on to the next one to fill any empty spaces. When you run it a second time, nothing will change because all the memory will be filled. You will see the progress bar move quickly, showing only the highlighted color, and a still image will be displayed on the camera during the process.
### Ensuring Tamper Detection
### i18n/translations/de-DE.json
@@ -229,6 +229,7 @@
"QR Label": "QR-Etikett",
"Quantity": "Menge",
"RX Pin": "RX Pin",
+ "Read the documentation before proceeding": "Lesen Sie die Dokumentation, bevor Sie fortfahren",
"Reboot": "Neustart",
"Receive": "Empfangen",
"Region:": "Region:",
### i18n/translations/es-MX.json
@@ -229,6 +229,7 @@
"QR Label": "Etiqueta QR",
"Quantity": "Cantidad",
"RX Pin": "RX Pin",
+ "Read the documentation before proceeding": "Lea la documentación antes de continuar",
"Reboot": "Reiniciar",
"Receive": "Recepción",
"Region:": "Región:",
### i18n/translations/fr-FR.json
@@ -229,6 +229,7 @@
"QR Label": "Texte d'étiquette QR",
"Quantity": "Quantité",
"RX Pin": "RX Fiche",
+ "Read the documentation before proceeding": "Lisez la documentation avant de continuer",
"Reboot": "Redémarrer",
"Receive": "Recevoir",
"Region:": "Région :",
### i18n/translations/ja-JP.json
@@ -229,6 +229,7 @@
"QR Label": "QRラベル",
"Quantity": "数量",
"RX Pin": "RXピン",
+ "Read the documentation before proceeding": "続行する前にドキュメントをお読みください",
"Reboot": "再起動",
"Receive": "受け取る",
"Region:": "地域:",
### i18n/translations/ko-KR.json
@@ -229,6 +229,7 @@
"QR Label": "QR 라벨",
"Quantity": "수량",
"RX Pin": "RX 핀",
+ "Read the documentation before proceeding": "계속하기 전에 문서를 읽어보세요",
"Reboot": "종료",
"Receive": "받기",
"Region:": "지역:",
### i18n/translations/nl-NL.json
@@ -229,6 +229,7 @@
"QR Label": "QR-label",
"Quantity": "Aantal",
"RX Pin": "RX pin",
+ "Read the documentation before proceeding": "Lees de documentatie voordat u doorgaat",
"Reboot": "Opnieuw opstarten",
"Receive": "Ontvangen",
"Region:": "Regio:",
### i18n/translations/pt-BR.json
@@ -229,6 +229,7 @@
"QR Label": "Etiqueta QR",
"Quantity": "Quantidade",
"RX Pin": "Pino RX",
+ "Read the documentation before proceeding": "Leia a documentação antes de prosseguir",
"Reboot": "Reiniciar",
"Receive": "Recebimento",
"Region:": "Região:",
### i18n/translations/ru-RU.json
@@ -229,6 +229,7 @@
"QR Label": "QR-метка",
"Quantity": "Кол-во",
"RX Pin": "RX Пин",
+ "Read the documentation before proceeding": "Прочитайте документацию перед продолжением",
"Reboot": "Перезагрузить",
"Receive": "Получить",
"Region:": "Регион:",
### i18n/translations/tr-TR.json
@@ -229,6 +229,7 @@
"QR Label": "QR Etiket",
"Quantity": "Miktar",
"RX Pin": "RX Pini",
+ "Read the documentation before proceeding": "Devam etmeden önce belgeleri okuyun",
"Reboot": "Yeniden Başlat",
"Receive": "Al",
"Region:": "Bölge:",
### i18n/translations/vi-VN.json
@@ -229,6 +229,7 @@
"QR Label": "Nhãn QR",
"Quantity": "Số lượng",
"RX Pin": "RX Pin",
+ "Read the documentation before proceeding": "Đọc tài liệu trước khi tiếp tục",
"Reboot": "Khởi động lại",
"Receive": "Nhận được",
"Region:": "Vùng:",
### i18n/translations/zh-CN.json
@@ -229,6 +229,7 @@
"QR Label": "二维码标签",
"Quantity": "数量",
"RX Pin": "RX 引脚",
+ "Read the documentation before proceeding": "继续之前请阅读文档",
"Reboot": "重启",
"Receive": "接收",
"Region:": "区域:",
### src/krux/pages/settings_page.py
@@ -151,8 +151,12 @@ def enter_modify_tc_code(self):
self.ctx.display.clear()
if not self.prompt(
- t("Enter a 6+ characters Tamper Check Code") + "\n" + t("(Experimental)"),
- self.ctx.display.height() // 2,
+ t("Enter a 6+ characters Tamper Check Code")
+ + "\n\n"
+ + t("(Experimental)")
+ + "\n"
+ + t("Read the documentation before proceeding"),
+ self.ctx.display.height() // 2 + FONT_HEIGHT,
):
return MENU_CONTINUE
### src/krux/translations/__init__.py
@@ -263,6 +263,7 @@
1175214440,
1720022112,
710709610,
+ 1193334070,
3338633658,
2697857197,
1658501467,
### src/krux/translations/de.py
@@ -251,6 +251,7 @@
"QR-Etikett",
"Menge",
"RX Pin",
+ "Lesen Sie die Dokumentation, bevor Sie fortfahren",
"Neustart",
"Empfangen",
"Region:",
### src/krux/translations/es.py
@@ -251,6 +251,7 @@
"Etiqueta QR",
"Cantidad",
"RX Pin",
+ "Lea la documentación antes de continuar",
"Reiniciar",
"Recepción",
"Región:",
### src/krux/translations/fr.py
@@ -251,6 +251,7 @@
"Texte d'étiquette QR",
"Quantité",
"RX Fiche",
+ "Lisez la documentation avant de continuer",
"Redémarrer",
"Recevoir",
"Région\u2009:",
### src/krux/translations/ja.py
@@ -251,6 +251,7 @@
"QRラベル",
"数量",
"RXピン",
+ "続行する前にドキュメントをお読みください",
"再起動",
"受け取る",
"地域:",
### src/krux/translations/ko.py
@@ -251,6 +251,7 @@
"QR 라벨",
"수량",
"RX 핀",
+ "계속하기 전에 문서를 읽어보세요",
"종료",
"받기",
"지역:",
### src/krux/translations/nl.py
@@ -251,6 +251,7 @@
"QR-label",
"Aantal",
"RX pin",
+ "Lees de documentatie voordat u doorgaat",
"Opnieuw opstarten",
"Ontvangen",
"Regio:",
### src/krux/translations/pt.py
@@ -251,6 +251,7 @@
"Etiqueta QR",
"Quantidade",
"Pino RX",
+ "Leia a documentação antes de prosseguir",
"Reiniciar",
"Recebimento",
"Região:",
### src/krux/translations/ru.py
@@ -251,6 +251,7 @@
"QR-метка",
"Кол-во",
"RX Пин",
+ "Прочитайте документацию перед продолжением",
"Перезагрузить",
"Получить",
"Регион:",
### src/krux/translations/tr.py
@@ -251,6 +251,7 @@
"QR Etiket",
"Miktar",
"RX Pini",
+ "Devam etmeden önce belgeleri okuyun",
"Yeniden Başlat",
"Al",
"Bölge:",
### src/krux/translations/vi.py
@@ -251,6 +251,7 @@
"Nhãn QR",
"Số lượng",
"RX Pin",
+ "Đọc tài liệu trước khi tiếp tục",
"Khởi động lại",
"Nhận được",
"Vùng:",
### src/krux/translations/zh.py
@@ -251,6 +251,7 @@
"二维码标签",
"数量",
"RX 引脚",
+ "继续之前请阅读文档",
"重启",
"接收",
"区域:",Why this scored 26/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.