TMRemote CLI Reference | HALRAD Documentation

TMRemote.exe provides a unified command-line interface for controlling Windows displays, HDMI matrix routing, and CEC device commands.

Display Commands

displays - List Connected Displays

Shows all connected displays with detailed information.

TMRemote displays

Example Output:

Connected Displays:
  1: DELL U2718Q (Internal)
     Resolution: 3840x2160 @ 60Hz
     Position: 0, 0
     Orientation: Landscape
     Primary: Yes

  2: LG 27UK850 (External)
     Resolution: 3840x2160 @ 60Hz
     Position: 3840, 0
     Orientation: Landscape
     Primary: No

  3: ASUS PA278QV (External)
     Resolution: 2560x1440 @ 60Hz
     Position: -2560, 0
     Orientation: Portrait
     Primary: No

rotate - Display Rotation

Rotate display orientation between Landscape and Portrait modes.

Command	Description
`rotate <n>`	Toggle display n between Landscape and Portrait
`rotate <n> L`	Set display n to Landscape orientation
`rotate <n> P`	Set display n to Portrait orientation

Examples:

# Toggle display 1 orientation
TMRemote rotate 1

# Set display 2 to Landscape
TMRemote rotate 2 L

# Set display 3 to Portrait
TMRemote rotate 3 P

status - System Status

Shows current display and matrix routing status.

TMRemote status

Matrix Commands

These commands control the OREI HDMI matrix switch. Connect to the matrix first using the connect command.

connect / disconnect - Matrix Connection

Command	Description
`connect <ip>`	Connect to matrix at specified IP address
`disconnect`	Disconnect from current matrix
`discover [timeout]`	Discover matrix devices on network

# Connect to matrix
TMRemote connect 192.168.1.50

# Discover devices on network
TMRemote discover

# Disconnect
TMRemote disconnect

route - Video Routing

Route HDMI inputs to outputs on the matrix switch.

Command	Description
`route <input> <output>`	Route input (1-8) to output (1-8)
`route <input> all`	Route input to all outputs
`route 1:1,2:2,...`	Set multiple routes at once

# Route input 1 to output 2
TMRemote route 1 2

# Route input 3 to all outputs
TMRemote route 3 all

# Set multiple routes
TMRemote route 1:1,2:2,3:3,4:4

routes - Show Routing Table

Display the current video routing configuration.

TMRemote routes

Example Output:

Video Routing:
--------------
  Output 1 <- Input 1
  Output 2 <- Input 1
  Output 3 <- Input 2
  Output 4 <- Input 3
  Output 5 <- Input 4
  Output 6 <- Input 4
  Output 7 <- Input 5
  Output 8 <- Input 6

preset - Device Presets

Device presets are stored on the matrix hardware.

Command	Description
`preset recall <1-8>`	Recall a device preset
`preset save <1-8>`	Save current routing to a device preset

# Recall device preset 1
TMRemote preset recall 1

# Save current routing to preset 3
TMRemote preset save 3

load/save - Matrix Profiles

Software-based routing configurations stored on your computer.

Command	Description
`load <profile>`	Load a matrix profile from file
`save <profile>`	Save current routing to profile

# Load the 'Gaming' profile
TMRemote load Gaming

# Save current routing
TMRemote save "Work Setup"

power - Power Control

Command	Description
`power on`	Turn matrix on
`power off`	Turn matrix off
`power status`	Show power status

audio - Audio Settings

Command	Description
`audio <0-8>`	Set external audio input (0=off, 1-8=input)
`audio mode <0-2>`	Set SPDIF mode (0=Bind, 1=Bind Output, 2=Matrix)

CEC Commands (HDMI-CEC)

Control connected HDMI devices via Consumer Electronics Control (CEC). Supports power control, volume, and playback commands.

Output Device Commands (TVs/Displays)

Command	Description
`cec on`	Power on all output displays
`cec off`	Power off all output displays
`cec output <n\|all> on`	Power on specific output(s)
`cec output <n\|all> off`	Power off specific output(s)
`cec output <n\|all> volup`	Increase volume
`cec output <n\|all> voldown`	Decrease volume
`cec output <n\|all> mute`	Toggle mute
`cec output <n\|all> active`	Set as active source (wake TV + switch input)

Input Device Commands (Sources)

Command	Description
`cec input <n\|all> on\|off`	Power control
`cec input <n\|all> play\|pause\|stop`	Playback control
`cec input <n\|all> rew\|ff`	Rewind / Fast forward
`cec input <n\|all> prev\|next`	Previous / Next track
`cec input <n\|all> menu\|back`	Menu navigation
`cec input <n\|all> up\|down\|left\|right\|enter`	D-pad navigation
`cec input <n\|all> volup\|voldown\|mute`	Volume control

Examples:

# Power on all displays
TMRemote cec on

# Power on display 1 only
TMRemote cec output 1 on

# Power off all displays
TMRemote cec off

# Increase volume on display 1
TMRemote cec output 1 volup

# Send play command to input 2
TMRemote cec input 2 play

# Open menu on input 3 device
TMRemote cec input 3 menu

Monitor Profile Commands

Monitor profiles save and restore Windows display configurations including resolution, position, and multi-monitor arrangements.

profiles - List Profiles

List all available monitor profiles.

TMRemote profiles

profile - Manage Profiles

Command	Description
`profile apply <name>`	Apply a saved monitor profile
`profile save <name>`	Save current display configuration as a new profile
`profile delete <name>`	Delete an existing profile

Examples:

# List available profiles
TMRemote profiles

# Apply the 'Work' profile
TMRemote profile apply Work

# Save current display setup
TMRemote profile save "Gaming Setup"

# Delete old profile
TMRemote profile delete "Old Config"

Scenario Commands

Scenarios combine multiple actions: matrix routing, monitor profiles, audio settings, and power control into a single command.

scenarios - List Scenarios

List all available scenarios.

TMRemote scenarios

scenario - Manage Scenarios

Command	Description
`scenario run <name>`	Execute a scenario (applies all settings)
`scenario show <name>`	Display scenario configuration details
`scenario delete <name>`	Delete a scenario

Examples:

# List available scenarios
TMRemote scenarios

# Run the 'Gaming' scenario
TMRemote scenario run Gaming

# Show scenario details
TMRemote scenario show "Movie Night"

# Delete a scenario
TMRemote scenario delete "Old Setup"

Example Output (scenario show):

Scenario: Gaming
  Description: Full-screen gaming on main display
  Enabled: True
  Routing: O1<-I1 O2<-I1 O3<-I1 O4<-I1
  Monitor Profile: Gaming
  External Audio: Input 1
  Power On: True

Plugin Commands

TMRemote supports plugins for extending functionality. Plugins can provide additional device control, automation, and API endpoints.

plugins - List Plugins

List all installed plugins with their status.

TMRemote plugins

Example Output:

Plugins:
--------
ID                   Name                      Version    Status
---------------------------------------------------------------------------
OREI                 OREI Matrix Plugin        1.0.0      Active
Electromage          Electromage LED Control   1.0.0      Disabled

Total: 2 plugins, 1 devices

plugin - Manage Plugins

Command	Description
`plugin enable <id>`	Enable a plugin
`plugin disable <id>`	Disable a plugin
`plugin reload <id>`	Reload a plugin (disable then enable)
`plugin info <id>`	Show detailed plugin information

Examples:

# Enable a plugin
TMRemote plugin enable Electromage

# Disable a plugin
TMRemote plugin disable OREI

# Reload a plugin
TMRemote plugin reload OREI

# Show plugin details
TMRemote plugin info OREI

api-routes - List API Routes

List all HTTP API endpoints registered by plugins.

TMRemote api-routes

Connection Commands

Manage the connection to the HDMI matrix.

connect - Connect to Matrix

TMRemote connect 192.168.1.100

disconnect - Disconnect

TMRemote disconnect

discover - Find Devices

Discover matrix devices on the network.

# Discover with default 5 second timeout
TMRemote discover

# Discover with 10 second timeout
TMRemote discover 10000

Interactive Mode

Launch TMRemote without arguments to enter interactive mode for multiple commands.

TMRemote

Matrix> status
Matrix> route 1 2
Matrix> cec on
Matrix> exit

Quick Reference

TMRemote <command> [options]

General Commands:
  help [command]              Show help (or help for specific command)
  status                      Show system status

Matrix Commands:
  connect <ip>                Connect to matrix at IP address
  disconnect                  Disconnect from matrix
  discover [timeout]          Discover matrix devices on network
  route <in> <out|all>        Route input to output(s)
  routes                      Show current video routing table
  preset recall <1-8>         Recall device preset
  preset save <1-8>           Save to device preset
  power [on|off]              Get/set power state
  audio [0-8]                 Get/set external audio input
  cec <target> <port> <cmd>   Send CEC command

Monitor Profile Commands:
  profiles                    List available monitor profiles
  profile apply <name>        Apply a monitor profile
  profile save <name>         Save current display config
  profile delete <name>       Delete a monitor profile

Scenario Commands:
  scenarios                   List available scenarios
  scenario run <name>         Execute a scenario
  scenario show <name>        Show scenario details
  scenario delete <name>      Delete a scenario

Plugin Commands:
  plugins                     List all plugins and status
  plugin enable <id>          Enable a plugin
  plugin disable <id>         Disable a plugin
  plugin reload <id>          Reload a plugin
  plugin info <id>            Show plugin details
  api-routes                  List registered API routes

Display Commands:
  displays                    List connected displays
  rotate <n> [L|P]            Toggle/set display orientation
  primary <n>                 Set primary display
  mode <internal|clone|extend|external>  Set projection mode

Display Commands

displays - List Connected Displays

rotate - Display Rotation

status - System Status

Matrix Commands

connect / disconnect - Matrix Connection

route - Video Routing

routes - Show Routing Table

preset - Device Presets

load/save - Matrix Profiles

power - Power Control

audio - Audio Settings

CEC Commands (HDMI-CEC)

Output Device Commands (TVs/Displays)

Input Device Commands (Sources)

Monitor Profile Commands

profiles - List Profiles

profile - Manage Profiles

Scenario Commands

scenarios - List Scenarios

scenario - Manage Scenarios

Plugin Commands

plugins - List Plugins

plugin - Manage Plugins

api-routes - List API Routes

Connection Commands

connect - Connect to Matrix

disconnect - Disconnect

discover - Find Devices

Interactive Mode

Quick Reference

See Also