bb-eco telemetry
Opt in to or out of anonymous firmware-update diagnostics shared with Brainboxes, or inspect what is sent.
Usage
bb-eco telemetry [<action>] [options]
Arguments
| Name | Description |
|---|---|
<action> | status (default), on, off, or show-last (the last report that was sent or queued) |
Options
| Option | Description |
|---|---|
--csv | Output in CSV format |
--json | Output in JSON format |
--timeout <timeout> | Override default timeout in milliseconds |
--verbose | Enable verbose/debug output |
-?, -h, --help | Show help and usage information |
Examples
See whether anonymous firmware-update diagnostics are on, and what has been sent:
bb-eco telemetry
Diagnostics: off
Installation ID: -
Queued reports: 0
Last sent: never
Endpoint: https://update.brainboxes.com/telemetry/v1/events
Turn them on. This creates a random installation ID, records your consent and queues one consent report; the next report is sent after each firmware-update attempt:
bb-eco telemetry on
Diagnostics: on
Installation ID: 9f1c0f7e-6b0a-4c1e-9d6c-2f5a3d8e1b77
Queued reports: 1
Last sent: never
Endpoint: https://update.brainboxes.com/telemetry/v1/events
Show the last report that was sent or queued, exactly as it went over the wire:
bb-eco telemetry show-last
Status: sent
At: 2026-09-04 15:02:11Z
{"schema":"bb-eco.telemetry.v1","installId":"9f1c0f7e-...","sentAt":"2026-09-04T15:02:11Z","client":{...},"events":[{"type":"firmware.upgrade.outcome","data":{"outcome":"Succeeded","model":"ED-588","fromVersion":"8.25","toVersion":"8.33",...}}]}
On the beta channel the reports are always on, so off is refused:
bb-eco telemetry off
Error: Diagnostics are always on for the beta channel. Switch BB Eco to the stable channel (Settings > About) first.
On the stable channel, turn them off. This deletes the installation ID and any unsent reports:
bb-eco telemetry off
Diagnostics: off
Installation ID: -
Queued reports: 0
Reports never contain IP addresses, device names or locations, usernames, file paths or
MAC addresses; each device appears only as a one-way hash. The same switch is on the
app's Settings page, and both write the same settings.json. To request deletion of what
an installation has sent, quote its installation ID to [email protected].
This page is auto-generated from the live CLI help text. Do not edit by hand - re-run node scripts/gen-cli-reference.mjs after changes. Example sections are maintained in docs/cli-examples/ in the bb-eco repo.