HDMI Matrix Setup Guide

Complete guide to configuring OREI HDMI Matrix control in TMRemote 2.73

Table of Contents


1. Prerequisites

Hardware Requirements

Supported Matrix Models:

Other matrices: Compatibility unknown - use at your own risk

Network Setup:

Software Requirements


2. Initial Matrix Configuration

Step 1: Physical Setup

  1. Connect Matrix to Network
    Matrix [LAN Port] --- Ethernet Cable --- Router/Switch
  2. Power On Matrix - Front panel LED should illuminate. Wait 30 seconds for boot.
  3. Find Matrix IP Address

Method A: Matrix Display (if available)

Method B: Router Admin Page

Method C: Default IP

OREI BK-808 default IP: 192.168.1.100

Step 2: Verify Matrix Accessibility

Ping Test:

ping 192.168.1.100

Expected: Reply from 192.168.1.100: bytes=32 time<1ms TTL=64

Web Interface Test:


3. Connecting to Matrix

First-Time Connection

  1. Launch TMRemote - Right-click system tray icon
  2. Navigate to: HDMI Matrix - Connect Matrix - Network (IP)...
  3. Enter IP Address - Dialog will show default: 192.168.1.100
  4. Verify Connection - Balloon notification shows connection status
Connection Persists: IP address saved to %APPDATA%\MonitorSwitcher\Matrix\matrix_settings.xml - No need to reconnect on restart.

Troubleshooting Connection

Problem: "Failed to connect to matrix"


4. Creating Matrix Profiles

Method 1: Save Current Routing

  1. Configure Matrix Routing via web interface or front panel
  2. Right-click tray icon - HDMI Matrix - Save Matrix Profile...
  3. Enter profile name and click OK

Profile saved to: %APPDATA%\MonitorSwitcher\Matrix\{ProfileName}.xml

Profile XML Structure

<?xml version="1.0"?>
<MatrixProfile>
  <ProfileName>Gaming Setup</ProfileName>
  <Description>Saved on 2025-11-26</Description>
  <PresetIndex>0</PresetIndex>
  <Routes>
    <int>3</int>  <!-- Output 1 <- Input 3 -->
    <int>3</int>  <!-- Output 2 <- Input 3 -->
    <int>1</int>  <!-- Output 3 <- Input 1 -->
    <int>5</int>  <!-- Output 4 <- Input 5 -->
    <int>1</int>
    <int>2</int>
    <int>3</int>
    <int>4</int>
  </Routes>
  <ExternalAudioInput>0</ExternalAudioInput>
</MatrixProfile>

Method 2: Use Device Presets

Use the matrix's built-in presets (1-8) for faster switching:

<MatrixProfile>
  <ProfileName>Gaming (Preset 3)</ProfileName>
  <PresetIndex>3</PresetIndex>
  <!-- Routes ignored when PresetIndex > 0 -->
</MatrixProfile>

5. Loading Matrix Profiles

Manual Loading

  1. Right-click tray icon - HDMI Matrix - Load Matrix Profile...
  2. Select profile from list
  3. Routing applied to matrix

6. Profile Linking

Link monitor profiles with matrix profiles for automatic synchronization! When you load a monitor profile, the linked matrix profile automatically applies.

Link Configuration

Create link file at: %APPDATA%\MonitorSwitcher\MatrixLinks\{MonitorProfile}_Link.xml

<?xml version="1.0"?>
<MonitorMatrixProfile>
  <MonitorProfileName>Gaming</MonitorProfileName>
  <MatrixProfileName>Gaming Matrix</MatrixProfileName>
  <AutoApplyMatrix>true</AutoApplyMatrix>
  <PowerOnMatrix>false</PowerOnMatrix>
  <PowerOnDelayMs>2000</PowerOnDelayMs>
</MonitorMatrixProfile>

Link Options

OptionDescription
AutoApplyMatrixtrue = Auto-load matrix profile when loading monitor profile
PowerOnMatrixtrue = Send power ON command before applying routing
PowerOnDelayMsDelay after power on before applying routing (ms)

7. Advanced Features

External Audio Routing

Route HDMI audio from a specific input to the matrix's SPDIF/optical output:

<ExternalAudioInput>3</ExternalAudioInput>

Power Control

<PowerOn>true</PowerOn>   <!-- Power ON -->
<PowerOn>false</PowerOn>  <!-- Power OFF (standby) -->

Routing Patterns

Mirroring (Same Input to Multiple Outputs):

<Routes>
  <int>1</int>  <!-- Out 1 <- In 1 -->
  <int>1</int>  <!-- Out 2 <- In 1 (mirror) -->
  <int>1</int>  <!-- Out 3 <- In 1 (mirror) -->
  <int>1</int>  <!-- Out 4 <- In 1 (mirror) -->
  ...
</Routes>

8. Troubleshooting

Profile Not Applying

  1. Check Matrix Connection: ping 192.168.1.100
  2. Test Manual Command via tray menu
  3. Verify Profile File XML is valid
  4. Check Link File has AutoApplyMatrix=true

Wrong Routing Applied

Remember: Array index = Output number, Value = Input number

<Routes>
  <int>3</int>  <!-- Position 0 = Output 1 <- Input 3 -->
  <int>1</int>  <!-- Position 1 = Output 2 <- Input 1 -->
</Routes>

Slow Switching


9. API Reference

HTTP JSON API

Endpoint: POST http://{matrix-ip}/cgi-bin/instr

Content-Type: application/json

Common Commands

CommandJSON Body
Get System Status{"comhead":"get system status","language":0}
Set Power ON{"comhead":"set poweronoff","language":0,"power":1}
Set Power OFF{"comhead":"set poweronoff","language":0,"power":0}
Get Video Status{"comhead":"get video status","language":0}
Recall Preset{"comhead":"preset set","language":0,"index":3}

curl Example (Windows CMD)

curl -X POST http://192.168.1.100/cgi-bin/instr -H "Content-Type: application/json" -d"{\"comhead\":\"get system status\",\"language\":0}"

10. Command Line Tool: MatrixSwitcher

Basic Commands

# Show help
MatrixSwitcher help

# Route input to output
MatrixSwitcher route 1 2          # Input 1 to Output 2
MatrixSwitcher route 3 all        # Input 3 to All outputs

# Device presets
MatrixSwitcher preset 1           # Recall preset 1
MatrixSwitcher preset save 2      # Save current to preset 2

# Profile management
MatrixSwitcher load "Gaming"      # Load matrix profile
MatrixSwitcher save "Work"        # Save current routing

# Power control
MatrixSwitcher power on           # Power on
MatrixSwitcher power off          # Power off (standby)
MatrixSwitcher power status       # Show power state

# Status
MatrixSwitcher status             # Show all routing + status

# External audio (SPDIF output)
MatrixSwitcher audio 3            # Route input 3 to SPDIF out
MatrixSwitcher audio 0            # Disable external audio

# Settings
MatrixSwitcher ip                 # Show current IP
MatrixSwitcher ip 192.168.1.50    # Set matrix IP

Scripting Example

@echo off
REM Switch to gaming mode
MatrixSwitcher power on
timeout /t 2
MatrixSwitcher load "Gaming"
echo Gaming mode activated!

Summary

You now have complete knowledge of TMRemote's HDMI Matrix control:

Happy Switching!

↑ Top