Home Assistant custom integration for SDVoE API™ control.
RiverLink SDVoE Matrix is a Home Assistant custom integration that enables control of SDVoE™ (Software Defined Video over Ethernet) matrix systems via the SDVoE API™. This integration allows you to manage video routing, audio routing, and display modes directly from your Home Assistant dashboard.
- Home Assistant 2025.2.4 or newer
- BlueRiver® AVP devices with network-accessible API endpoint
- SDVoE API server running on your network (default port: 6970)
- Most users: Install IPA Manager - Setup guide
- Advanced users: Bring your own BlueRiver Control Server implementation
- SDVoE API™ version 2.13.0.0 or newer
Developer: switch180
- ✅ Device Discovery - Automatic detection of receivers and transmitters
- ✅ Video Routing - Dynamic source-to-display mapping via HDMI streams
- ✅ Audio Routing - HDMI embedded audio follows video routing
- ✅ Temperature Monitoring - Real-time device temperature sensors
- ✅ Connection Status - Online/offline state for all devices
- ✅ Stream State Tracking - Monitor active/inactive video streams
- ✅ Display Modes - Full support for all 5 modes:
- Genlock (zero-frame latency passthrough)
- Genlock Scaling (low-latency with resolution conversion)
- Fast Switch (multi-source switching, aspect-preserved)
- Fast Switch Stretch (multi-source, stretch to fill)
- Fast Switch Crop (multi-source, crop to fit)
- ✅ Resolution Presets - 26 named presets (broadcast + computer formats)
- ✅ Custom Resolutions - Support for non-standard resolutions via genlock mode
- ✅ Signal Information - Resolution, color space, HDCP status, bit depth
-
Per Receiver (9 entities):
- 6 Sensors: Temperature, Video Source, Audio Source, Video Signal, IP Address, Firmware
- 3 Binary Sensors: Online, Video Streaming, Audio Streaming
- 3 Selects: Video Source, Display Mode, Resolution Preset
-
Per Transmitter (7 entities):
- 6 Sensors: Temperature, HDMI Stream, Audio Stream, Input Signal, IP Address, Firmware
- 1 Binary Sensor: Online
- ⏳ Multiview/PIP - Picture-in-picture and multiview displays
- ⏳ Videowall APIs - Synchronized multi-display configurations
- ⏳ Service Calls - Advanced automation via Home Assistant services
- ⏳ Audio-Only Routing - Independent audio matrix functionality
⚠️ Important: Before installing the integration, you must set up the BlueRiver Control Server (or bring your own SDVoE API server). This is required for the integration to communicate with your SDVoE devices.
- Set up BlueRiver Control Server - Step-by-step guide
- Install the Integration - Installation instructions
- Configure in Home Assistant - Configuration guide
- Start Using SDVoE - Usage examples
📖 Read the complete Getting Started Guide →
Contributions are welcome! Please read the Contributing Guide for:
- Development environment setup
- Code of conduct
- Development workflow
- Pull request process
- Coding standards
This project is licensed under the MIT License - see the LICENSE file for details.
- 🐛 Report a bug: Open an issue
- ✨ Request a feature: Open an issue
- 📖 Documentation: Getting Started Guide
This project is an independent open-source integration developed by the community. RiverLink SDVoE Matrix is NOT affiliated with, endorsed by, sponsored by, or officially connected to the SDVoE Alliance®, Semtech Corporation®, or any other trademark holder mentioned in this documentation. This integration does not contain any properitary code of the aforementioned organizations.
This integration is designed purely for interoperability with SDVoE™ technology and the SDVoE API™. We respect all intellectual property rights and make no claims to ownership of any third-party trademarks, service marks, or proprietary technologies referenced herein. The development of this integration is an independent effort to enable Home Assistant users to control their SDVoE™-compatible devices.
- SDVoE™, SDVoE API™, and SDVoE Alliance® are trademarks of the SDVoE Alliance.
- BlueRiver® and Semtech® are registered trademarks of Semtech Corporation or its affiliates.
All other trademarks, service marks, and trade names referenced in this project are the property of their respective owners.
This project is licensed under the MIT License and implements interoperability with the SDVoE API™. The integration does not redistribute any proprietary content, firmware, or copyrighted materials from third parties. All API specifications, protocols, and documentation are the property of their respective owners and are used solely for the purpose of enabling interoperability.