shelly discover ble

shelly discover ble

Discover devices using Bluetooth Low Energy

Synopsis

Discover Shelly devices using Bluetooth Low Energy (BLE).

This method finds Shelly devices that are in provisioning mode or BLU devices broadcasting BTHome sensor data.

Requirements:

  • Bluetooth adapter on the host machine
  • Bluetooth must be enabled
  • May require elevated privileges on some systems
1
shelly discover ble [flags]

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
  # Basic BLE discovery
  shelly discover ble

  # With longer timeout
  shelly discover ble --timeout 30s

  # Include BTHome sensor data
  shelly discover ble --bthome

  # Filter by device name prefix
  shelly discover ble --filter "Shelly"

Options

1
2
3
4
      --bthome             Include BTHome sensor broadcasts
  -f, --filter string      Filter by device name prefix
  -h, --help               help for ble
  -t, --timeout duration   Discovery timeout (default 15s)

Options inherited from parent commands

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
      --config string           Config file (default $HOME/.config/shelly/config.yaml)
      --log-categories string   Filter logs by category (comma-separated: network,api,device,config,auth,plugin)
      --log-json                Output logs in JSON format
      --no-color                Disable colored output
      --no-headers              Hide table headers in output
      --offline                 Only read from cache, error on cache miss
  -o, --output string           Output format (table, json, yaml, template) (default "table")
      --plain                   Disable borders and colors (machine-readable output)
  -q, --quiet                   Suppress non-essential output
      --refresh                 Bypass cache and fetch fresh data from device
      --template string         Go template string for output (use with -o template)
  -v, --verbose count           Increase verbosity (-v=info, -vv=debug, -vvv=trace)

SEE ALSO