Control your Bond-connected ceiling fans, fireplaces, and other RF/IR devices directly from your Unfolded Circle Remote 2 or Remote 3 with PIN-based authentication, auto-discovery, and full device support.
This integration provides comprehensive control of Bond-connected devices through the Bond Local API, delivering seamless integration with your Unfolded Circle Remote for complete RF/IR device control.
If you find this integration useful, consider supporting development:
- Power Control - Turn on/off, toggle
- Speed Control - Adjust fan speed (multiple levels)
- Direction Control - Reverse fan direction
- Light Control - Integrated light on/off and toggle
- Power Control - Turn on/off, toggle
- Flame Control - Adjust flame height
- Fan Control - Blower fan speed adjustment
- Position Control - Open/close, position adjustment
- Stop Command - Stop movement at current position
- Power Control - On/off, toggle
- Brightness Control - Adjust light brightness levels
- Power Control - Basic on/off and toggle
- Action Support - All available device actions
- Secure Setup - Using your Bond device's PIN
- Automatic Unlock - Integration unlocks Bond device with PIN
- Token Management - Secure token storage for future use
- Network Discovery - Automatically find Bond hubs on local network
- Device Discovery - All configured devices automatically discovered
- Real-time Updates - Periodic polling for device state
- Main Page - Overview with all devices and quick controls
- Device Pages - Individual pages for each device
- Clear Labels - Device-specific UI with descriptive text
- Organized Controls - Grouped by function for easy access
- Power Button - Primary device power toggle
- Volume Buttons - Fan speed or level control
- Channel Buttons - Available for custom mapping
- Protocol: Bond Local HTTP API v2
- Network Access: Bond hub must be on same local network
- Authentication: 4-digit PIN from device label
- Connection: Direct HTTP communication with command throttling
- Polling: 30-second interval for state updates
- Local Network Access - Integration requires same network as Bond hub
- HTTP Protocol - Bond Local API
- Static IP Recommended - Bond hub should have static IP or DHCP reservation
- Firewall - Must allow HTTP traffic
- Navigate to the Releases page
- Download the latest
uc-intg-bond-<version>-aarch64.tar.gzfile - Open your remote's web interface (
http://your-remote-ip) - Go to Settings → Integrations → Add Integration
- Click Upload and select the downloaded
.tar.gzfile
The integration is available as a pre-built Docker image from GitHub Container Registry:
Image: ghcr.io/mase1981/uc-intg-bond:latest
Docker Compose:
services:
uc-intg-bond:
image: ghcr.io/mase1981/uc-intg-bond:latest
container_name: uc-intg-bond
network_mode: host
volumes:
- </local/path>:/data
environment:
- UC_CONFIG_HOME=/data
- UC_INTEGRATION_HTTP_PORT=9090
- UC_INTEGRATION_INTERFACE=0.0.0.0
- PYTHONPATH=/app
restart: unless-stoppedDocker Run:
docker run -d --name uc-bond --restart unless-stopped --network host -v bond-config:/app/config -e UC_CONFIG_HOME=/app/config -e UC_INTEGRATION_INTERFACE=0.0.0.0 -e UC_INTEGRATION_HTTP_PORT=9090 -e PYTHONPATH=/app ghcr.io/mase1981/uc-intg-bond:latestIMPORTANT: Bond hub must be powered on and connected to your network before adding the integration.
- Router Admin Panel: Check connected devices (recommended: set static IP)
- Bond App: Look in device settings
- Network Scanner: Use tools like Advanced IP Scanner
- Command Line:
# Windows arp -a | findstr "b0-ce-18" # Linux/Mac arp -a | grep "b0:ce:18"
- Look for a 4-digit number on a sticker on your Bond device (usually on the bottom or back)
- Wired Connection: Recommended for stability
- Static IP: Recommended via DHCP reservation
- Firewall: Allow HTTP traffic
- Network Isolation: Must be on same subnet as Remote
- After installation, go to Settings → Integrations
- The Bond integration should appear in Available Integrations
- Click "Configure" to begin setup:
- Bond IP Address: Enter Bond hub IP (e.g., 192.168.1.100)
- Bond PIN: Enter 4-digit PIN from device label
- Click Complete Setup
- Integration unlocks Bond device using PIN
- Secure token obtained and stored
- All configured devices discovered
- Remote control entities created
- Integration will create entities:
- Remote:
remote.bond_[device_name]for each device - Main Remote: Overview page with all devices
- Remote:
The integration creates remote entities with multiple pages:
-
Main Page: Overview with all devices and quick controls
- Device names above control buttons
- "Turn On", "Turn Off", "Toggle" for each device
-
Device Pages: Individual pages for each device
- Power Controls: Turn On, Turn Off, Power Toggle
- Level Controls: Speed +/-, Flame +/-, Brightness +/-
- Light Controls: Light On/Off, Light Toggle
- Other Controls: Direction, Timer, Stop, etc.
- Power Button: Primary device power toggle
- Volume Up/Down: Fan speed or level control
- Channel Buttons: Available for custom mapping
| Type | Description | Controls |
|---|---|---|
| Ceiling Fans (CF) | Power, speed, direction, light | Full control |
| Fireplaces (FP) | Power, flame, fan | Full control |
| Motorized Shades (MS) | Open/close, position | Full control |
| Lights (LT) | On/off, brightness | Full control |
| Generic (GX) | Basic controls | Available actions |
- Developer: Meir Miyara
- Bond: RF/IR device control platform
- Unfolded Circle: Remote 2/3 integration framework (ucapi)
- Protocol: Bond Local HTTP API v2
- Community: Testing and feedback from UC community
This project is licensed under the Mozilla Public License 2.0 (MPL-2.0) - see LICENSE file for details.
- GitHub Issues: Report bugs and request features
- UC Community Forum: General discussion and support
- Developer: Meir Miyara
- Bond Support: Official Bond Support
Made with ❤️ for the Unfolded Circle and Bond Communities
Thank You: Meir Miyara
