TMRemote 2.73 README | HALRAD Documentation

Be a video wizard. TMRemote is a Windows system tray application that manages monitor display profiles and HDMI matrix routing. Control your entire desktop A/V setup with hotkeys, scenarios, and unified profiles.

Matrix Control – 8×8 HDMI switching, presets, EDID, audio extraction, CEC device control
Display Control – Monitor profiles, rotation, primary display, projection modes
Scenarios – Link matrix + display + audio into unified one-click workflows

Features

Monitor Profile Management

Save and restore multiple monitor configurations
Per-monitor settings: position, resolution, orientation, refresh rate
Display topology control: PC Screen Only, Duplicate, Extend, Second Screen Only
Hotkey support for quick profile switching
Quick profile access from This PC tab (load/save without switching tabs)

Visual Display Layout

Visual layout panel showing monitor arrangement like Windows Display Settings
All displays visible: Active, disabled, and disconnected monitors
Drag-and-drop repositioning with snap-to-edge alignment
Right-click context menu: Set Primary, Rotate, Enable/Disable, Identify
Color-coded status: Green=Primary, Blue=Active, Gray=Disabled, Red=Disconnected
Identify Displays: 5-second overlay showing monitor number, name, resolution, connection type
Connection info: Shows HDMI, DisplayPort, Internal, etc. for each display

HDMI Matrix Control

Control OREI HDMI Matrix (BK-808) via HTTP JSON API
Route any input to any output (8x8 matrix)
Route single input to all outputs (focus mode)
External audio routing to SPDIF output
Device presets (1-8) for instant switching
Power control integration

CEC Device Control (HDMI-CEC)

Power on/off connected TVs and displays
Volume control (up/down/mute) via CEC
Playback control for source devices (play/pause/stop)
Menu navigation for connected devices
Control individual ports or all ports at once

Scenarios

One-click scenarios combining matrix + monitor profiles
Scenario hotkeys for instant activation
Top-level tray menu access

Profiles Tab

Full CRUD for Monitor Profiles and Matrix Profiles
Visual matrix profile editor with routing grid
Profile linking for synchronized switching
Import/export profiles for backup and sharing

Requirements

OS: Windows 10 / 11
Framework: .NET Framework 4.8
Network: LAN access to HDMI matrix (for matrix control)

Quick Start

Installation

Download the latest release
Extract to your preferred location
Run TMRemote.exe
Application appears in system tray

Save Monitor Profile

Arrange monitors using Windows Display Settings
Right-click tray icon → Save Profile → New Profile...
Enter profile name → OK

Switch Profiles

Tray menu: Right-click → Select profile
Hotkey: Settings → Set Hotkeys → Assign key combination

Control Display Topology

Tray menu: Display Mode → PC Screen Only / Duplicate / Extend / Second Screen Only
Or: Settings → This PC → Display Mode buttons
CLI: TMRemote extend or TMRemote clone

HDMI Matrix Setup

Connect matrix to network (default IP: 192.168.1.100)
Right-click tray → Settings → Matrix tab
Enter matrix IP address
Enable "Matrix Control"

Command Line Reference

Matrix Commands

TMRemote status               # Show current routing status
TMRemote matrix               # Show visual matrix grid
TMRemote route 1 2            # Route input 1 to output 2
TMRemote route 3 all          # Route input 3 to all outputs (focus)
TMRemote preset 1             # Recall device preset 1
TMRemote profile Gaming       # Load matrix profile
TMRemote power on             # Power on matrix

Audio Commands

TMRemote audio                # Show audio status
TMRemote audio 2              # Set external audio to input 2
TMRemote audio 0              # Disable external audio
TMRemote audio mode 0         # SPDIF: Bind to Input
TMRemote audio mode 1         # SPDIF: Bind to Output
TMRemote audio mode 2         # SPDIF: Audio Matrix

Audio Routing in GUI

The Settings window provides visual audio control:

Status Bar Audio Display - Shows current external audio routing (e.g., "Audio: Input 3" or "Audio: Off")
Quick Audio Dropdown - Click the dropdown arrow next to the audio status to quickly change audio routing without editing profiles
Scenario Audio Setting - When creating or editing a scenario, use the "External Audio" dropdown to set which input provides audio when the scenario is activated

CEC Commands (HDMI-CEC Device Control)

# Quick power control
TMRemote cec on               # Power on all output displays
TMRemote cec off              # Power off all output displays

# Output control (TVs/Displays)
TMRemote cec output 1 on      # Power on display 1
TMRemote cec output all off   # Power off all displays
TMRemote cec output 1 volup   # Volume up on display 1
TMRemote cec output 1 mute    # Toggle mute on display 1
TMRemote cec output 1 active  # Set display 1 as active source

# Input control (Source devices)
TMRemote cec input 2 play     # Send play to source on input 2
TMRemote cec input 2 pause    # Send pause
TMRemote cec input 3 menu     # Open menu on input 3 device
TMRemote cec input 1 enter    # Select/OK

Display Commands

TMRemote displays             # List all displays with resolution/scale/type
TMRemote rotate 2             # Toggle display 2 landscape/portrait
TMRemote rotate 2 P           # Set display 2 to portrait
TMRemote rotate 2 L           # Set display 2 to landscape
TMRemote primary 1            # Set display 1 as primary

Display Mode Commands (Win+P equivalent)

TMRemote mode internal        # PC screen only
TMRemote mode clone           # Duplicate on all displays
TMRemote mode extend          # Extend desktop
TMRemote mode external        # Second screen only

# Shortcuts
TMRemote internal             # Same as mode internal
TMRemote pc                   # Same as mode internal
TMRemote clone                # Same as mode clone
TMRemote extend               # Same as mode extend
TMRemote external             # Same as mode external

Configuration

TMRemote ip 192.168.1.50      # Set matrix IP address
TMRemote ip                   # Show current matrix IP
TMRemote cli                  # Enter interactive CLI mode
TMRemote help                 # Show help

See CLI Reference for complete documentation.

File Locations

%APPDATA%\MonitorSwitcher\
├── Profiles\              # Monitor display profiles (*.xml, includes hotkeys)
├── Matrix\                # Matrix routing profiles + matrix_settings.xml
├── MatrixLinks\           # Monitor-to-Matrix profile linkages
├── Scenarios\             # Combined scenario configurations
└── QuickActions\          # Quick action definitions

Settings Tabs

Tab	Description
Matrix	IP address, connection settings, notifications
Scenarios	Create/edit scenarios combining profiles
Profiles	Monitor + Matrix profile CRUD, linking
This PC	Visual display layout, quick profile switching, display control, topology modes
About	Version info, folder shortcuts

Triangularity Control Architecture

TMRemote implements a unified three-mode interface across all features:

Mode	Description
UX Mode	Visual graphical interface with buttons, sliders, and matrix grid
CMD Mode	Command mode for direct control operations and quick actions
CLI Mode	Command-line interface for scripting and remote configuration

License

Mozilla Public License 2.0 (MPL-2.0)

Credits

Forged by: martink84 (monitor-switcher) 🙏
Welded by: HALRAD (TMRemote@halrad.com)

Links

TMRemote 2.73 - Commands your desktop audio and video