🤖 SwitchBot Configuration
API Credentials
Token:
Secret:
Save
Discover Devices
Auto-add all
ⓘ
Adds all discovered devices automatically; already configured devices are skipped.
Scan:
3s
5s
10s
15s
Timeout:
s
Disable BLE scan
Bluetooth: checking...
Last scanned: never
Auto-refresh:
Off
30s
1m
5m
Refresh
🔍 Discover
Available Devices
Configured Devices
Loading…
🗑️ Remove All Devices
Advanced Settings
Enable Matter Support (Override)
Manually enable Matter support. By default, Matter is auto-detected from the child bridge configuration. Only change this if you need to override the auto-detection.
Prefer Matter when available
If enabled and Matter is available, devices will be presented as Matter accessories where supported (instead of HAP).
Enable BLE (Bluetooth)
Enable or disable BLE (Bluetooth Low Energy) support. If disabled, only OpenAPI (cloud) will be used.
Enable BLE Polling Fallback
If enabled, the plugin will periodically poll BLE devices for status as a safety net in addition to real-time notifications. This helps recover from missed notifications or connection loss. Recommended for reliability. Can be overridden per device.
BLE Polling Interval (ms)
How often to poll BLE devices for status (in milliseconds). Default is 600000 (10 minutes). Set higher to reduce battery drain. Minimum 60000 (1 minute). Can be overridden per device.
OpenAPI Polling Interval (seconds)
How often to poll devices via OpenAPI for status. Default: 300 (5 min). Min: 30. Can be overridden per device.
Enable Batched OpenAPI Polling
Poll all OpenAPI devices in a single batch at the configured interval. Devices with per-device refreshRate are excluded from the batch.
OpenAPI Batch Polling Interval (seconds)
Interval for batched OpenAPI polling. Falls back to OpenAPI Polling Interval if not set. Default: 300.
OpenAPI Daily Request Limit
Maximum OpenAPI requests per day allowed by the plugin. Default: 10000.
OpenAPI Reserve for Commands
Requests reserved for user actions. When remaining budget reaches this value, background polling pauses. Default: 1000.
Reset OpenAPI Counter at Local Midnight
If true, resets the daily OpenAPI request counter at local midnight. If false, resets at UTC midnight.
Only Allow Webhooks on Reserve
When remaining OpenAPI budget reaches the reserve, only webhooks and user commands are allowed. Background polling/discovery pauses.
OpenAPI Batch Concurrency
Maximum number of parallel OpenAPI status calls during a batch. Default: 5.
OpenAPI Batch Jitter (seconds)
Random startup delay before the first batch to reduce synchronized spikes. Default: 0.
Save Advanced Settings