TMRemote CLI Reference

Command Line Interface for Display and Matrix Control

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. The matrix IP must be configured first.

ip - Configure Matrix IP

Command Description
ip <address> Set the matrix IP address (saved to settings)
ip Show current matrix IP address
# Set the matrix IP address
TMRemote ip 192.168.1.50

# Show current IP
TMRemote ip

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

preset - Device Presets

Device presets are stored on the matrix hardware.

Command Description
preset <1-8> Recall a device preset
preset save <1-8> Save current routing to a device preset
# Load device preset 1
TMRemote preset 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

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]

Display Commands:
  displays                    List connected displays
  rotate <n>                  Toggle display orientation
  rotate <n> L|P              Set Landscape or Portrait
  status                      Show system status

Matrix Commands:
  ip [address]                Show/set matrix IP address
  route <in> <out|all>        Route input to output(s)
  route 1:1,2:2,...           Set multiple routes
  preset <1-8>                Recall device preset
  preset save <1-8>           Save to device preset
  load <profile>              Load matrix profile
  save <profile>              Save matrix profile
  power on|off|status         Power control
  audio <0-8>                 Set external audio input
  audio mode <0-2>            Set SPDIF mode

CEC Commands:
  cec on|off                  Power all outputs on/off
  cec output <n|all> <cmd>    TV: on|off|volup|voldown|mute|active
  cec input <n|all> <cmd>     Source: on|off|play|pause|menu|...

Other:
  help                        Show help
  exit                        Exit interactive mode

See Also


TMRemote 2.73 - Commands your desktop audio and video

Top