Skip to content

hfVisualizer Remote Control Remote-only

Use these commands to discover target instances, inspect runtime state, and work with remote script files before sending model or view commands.

list

hfVisualizer --remote list
  • Prints the running hfVisualizer instances that can accept remote-control requests.
  • Use this first when you need an explicit target id for --target <id>.

target

hfVisualizer --remote target <set|show|clear> [id]
  • Manages the local default target used when --target is omitted.
  • set [id] stores the selected instance as the local default target.
  • show prints the current local default target.
  • clear removes the stored local default target.
  • target set/show/clear are local client commands and do not send remote-control requests to the GUI process.
  • See the top-level Remote Control Overview page for the full target-selection flow.

status

hfVisualizer --remote [--target <id>] status
  • Returns runtime status for the target instance.
  • Use it to confirm the current mode and runtime state before sending other commands.

ping

hfVisualizer --remote [--target <id>] ping
  • Tests remote-control connectivity without changing model or view state.

focus

hfVisualizer --remote [--target <id>] focus
  • Restores the window if needed, then raises and activates it.
  • This is a remote-only UI helper.
  • It does not change model data and does not append a canonical command tail to Remote Control History.

maximize

hfVisualizer --remote [--target <id>] maximize
  • Switches the target window to the maximized state, then raises and activates it.
  • This is a remote-only UI helper.
  • It does not change model data and does not append a canonical command tail to Remote Control History.

minimize

hfVisualizer --remote [--target <id>] minimize
  • Minimizes the target window.
  • This is a remote-only UI helper.
  • It does not change model data and does not append a canonical command tail to Remote Control History.

script

hfVisualizer --remote [--target <id>] [--timeout-ms <ms>] script <file>
  • Runs a saved remote-control script file against the target instance.
  • --timeout-ms <ms> overrides the wait timeout for the whole script request.
  • The script file is interpreted as a sequence of remote-control command lines.

script-save

hfVisualizer --remote [--target <id>] script-save [file]
  • Writes the accumulated Remote Control History tails to a file.
  • Without [file], the default script output path is used.
  • Use this when you want a replayable command script from the current session history.

Example:

hfVisualizer --remote list
hfVisualizer --remote target show
hfVisualizer --remote status
hfVisualizer --remote ping
hfVisualizer --remote maximize
hfVisualizer --remote focus
hfVisualizer --remote minimize
hfVisualizer --remote script-save D:\Work\hfVisualizer.ipc.txt
hfVisualizer --remote script D:\Work\hfVisualizer.ipc.txt