Table of Contents
1. Prerequisites
Hardware Requirements
Supported Matrix Models:
- OREI BK-808 8x8 HDMI Matrix Switcher (tested and verified)
Network Setup:
- Matrix connected to local network (Ethernet)
- PC on same network as matrix
- Matrix with static or known DHCP IP address
Software Requirements
- TMRemote 2.73 or later
- Windows 10 / 11
- .NET Framework 4.8 or higher
2. Initial Matrix Configuration
Step 1: Physical Setup
- Connect Matrix to Network
Matrix [LAN Port] --- Ethernet Cable --- Router/Switch - Power On Matrix - Front panel LED should illuminate. Wait 30 seconds for boot.
- Find Matrix IP Address
Method A: Matrix Display (if available)
- Press
MENUbutton on matrix - Navigate to
Network Settings - Note IP address shown
Method B: Router Admin Page
- Log into router (usually
192.168.1.1) - Find "Connected Devices" or "DHCP Clients"
- Look for device named "OREI" or "Matrix"
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:
- Open browser
- Navigate to:
http://192.168.1.100 - Should see OREI BK-808 matrix web interface
3. Connecting to Matrix
First-Time Connection
- Launch TMRemote - Right-click system tray icon
- Navigate to:
HDMI Matrix-Connect Matrix-Network (IP)... - Enter IP Address - Dialog will show default:
192.168.1.100 - Verify Connection - Balloon notification shows connection status
%APPDATA%\MonitorSwitcher\Matrix\matrix_settings.xml - No need to reconnect on restart.
Troubleshooting Connection
Problem: "Failed to connect to matrix"
- Solution 1: Verify Matrix Power -
ping 192.168.1.100 - Solution 2: Check Firewall settings
- Solution 3: Verify same network subnet
- Solution 4: Reset Matrix Network Settings (hold RESET 10 seconds)
4. Creating Matrix Profiles
Method 1: Save Current Routing
- Configure Matrix Routing via web interface or front panel
- Right-click tray icon -
HDMI Matrix-Save Matrix Profile... - 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
- Right-click tray icon -
HDMI Matrix-Load Matrix Profile... - Select profile from list
- Routing applied to matrix
6. Profile Linking
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
| Option | Description |
|---|---|
AutoApplyMatrix | true = Auto-load matrix profile when loading monitor profile |
PowerOnMatrix | true = Send power ON command before applying routing |
PowerOnDelayMs | Delay 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>
0= External audio disabled1-8= Route audio from specified input
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
- Check Matrix Connection:
ping 192.168.1.100 - Test Manual Command via tray menu
- Verify Profile File XML is valid
- 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
- Reduce
PowerOnDelayMs - Use Device Presets (single API call)
- Check network latency
9. API Reference
HTTP JSON API
Endpoint: POST http://{matrix-ip}/cgi-bin/instr
Content-Type: application/json
Common Commands
| Command | JSON 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:
- Connection: IP-based, no authentication
- Profiles: Save/load/link matrix routing
- Automation: Link with monitor profiles
- Advanced: External audio, power control, presets
- CLI: MatrixSwitcher.exe for scripting
Happy Switching!