TCP Listener · Windows · macOS · Linux

Remote Control for
Any Machine

VICREO Listener sits quietly on your machine, waiting for TCP commands to simulate keypresses, mouse events, and shell commands from any device on your network.

VICREO Listener — port 10001
// Connected on 192.168.1.10:10001 send TCP →{  "type""combination",  "key""tab",  "modifiers"["alt"],  "password""••••••••"} ✓ Key combination executed
Controllable by Companion
Works with Bitfocus Companion

Select theVICREO-Hotkey module in Companion for full integration.

Three steps to automate your workflow

1. Install

Download and install VICREO Listener on the machine you want to control. It runs silently in the background waiting for connections.

2. Connect

Check the app log for the host IP and port (default: 10001). Any device on your network can now send commands over TCP.

3. Send Commands

Send a JSON object with atype, key name, and optional modifiers. The Listener executes it instantly.

Get up and running in minutes

Download the right build for your OS and launch it on the machine you want to control. On your client machine, send TCP to the host IP on port 10001.

Download VICREO Listener
macOS
macOS

Silicon & Intel builds, signed and notarized

Windows
Windows

Windows 10+, signed with trusted certificate

Linux
Linux

Ubuntu/Debian .deb package (BETA)

Usage

Send a JSON object via TCP. The application reads thetype field first.

Available Types

presspressSpecialcombinationtrioquartetdownupprocessOSXstringshellfilemousePositionmouseClickmouseClickHoldmouseClickReleasemouseScrollgetMousePositionsetWindowToForeGroundsubscribeunsubscribe

Password

As of version 3.0.0 apassword field is required. Leave it empty in the Listener to accept an empty password. When set, hash it as an MD5 string.

To support older connection methods, leave the password empty in the Listener.

Examples

Key press

{ "key": "c", "type": "press", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Key combination

{ "key": "tab", "type": "combination", "modifiers": ["alt"], "password": "d41d8cd98f00b204e9800998ecf8427e" }

Key trio

{ "key": "left", "type": "trio", "modifiers": ["ctrl", "shift"], "password": "d41d8cd98f00b204e9800998ecf8427e" }

Put modifiers in an array. Supported: Alt/Option, Command/Win, Ctrl, Shift.

processOSX

{ "key": "tab", "type": "processOSX", "processName": "Microsoft PowerPoint", "modifiers": ["alt"], "password": "d41d8cd98f00b204e9800998ecf8427e" }

String message

{ "type": "string", "msg": "C:/Barco/InfoT1413.pdf", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Open file

{ "type": "file", "path": "C:/Barco/InfoT1413.pdf", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Shell command

{ "type": "shell", "shell": "dir", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Set mouse position

{ "type": "mousePosition", "x": "500", "y": "500", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Mouse click

{ "type": "mouseClick", "button": "left", "double": "false", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Mouse click hold

{ "type": "mouseClickHold", "button": "left", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Mouse click release

{ "type": "mouseClickRelease", "button": "left", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Mouse scroll

{ "type": "mouseScroll", "vertical": "3", "horizontal": "0", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Set window to foreground (Windows only)

{ "type": "setWindowToForeGround", "windowTitle": "Notepad", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Subscribe to events

{ "type": "subscribe", "name": "mousePosition", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Unsubscribe from events

{ "type": "unsubscribe", "name": "mousePosition", "password": "d41d8cd98f00b204e9800998ecf8427e" }

Supported Keys

KeyDescriptionNotes
backspaceForward delete (Delete key on extended keyboards)
deleteBackspace key
enterReturn/Enter key
tabTab key
escapeEscape key
upUp arrow
downDown arrow
rightRight arrow
leftLeft arrow
homeHome key
endEnd key
pageupPage Up
pagedownPage Down
f1Function key F1
f2Function key F2
f3Function key F3
f4Function key F4
f5Function key F5
f6Function key F6
f7Function key F7
f8Function key F8
f9Function key F9
f10Function key F10
f11Function key F11
f12Function key F12
f13Function key F13
f14Function key F14
f15Function key F15
f16Function key F16
f17Function key F17
f18Function key F18
f19Function key F19
f20Function key F20
commandCommand key (⌘)
altOption/Alt key
right_altRight Option key
controlControl key
right_ctrlRight Control key
shiftShift key
right_shiftRight Shift key
caps_lockCaps Lock
fnFunction (fn) modifier
spaceSpace bar
printscreenPrint ScreenNo Mac support
insertInsertNo Mac support
pausePause/BreakWindows only
scrolllockScroll LockWindows only
numlockNum LockWindows only
winWindows/Start keyWindows only
leftwindowsLeft Windows keyWindows only
rightwindowsRight Windows keyWindows only
keypaddecimalKeypad Decimal (.)
keypadmultiplyKeypad Multiply (*)
keypadplusKeypad Plus (+)
keypadclearKeypad Clear
keypaddivideKeypad Divide (/)
keypadenterKeypad Enter
keypadminusKeypad Minus (-)
keypadequalsKeypad Equals (=)
numpad_0Numpad 0No Linux support
numpad_1Numpad 1No Linux support
numpad_2Numpad 2No Linux support
numpad_3Numpad 3No Linux support
numpad_4Numpad 4No Linux support
numpad_5Numpad 5No Linux support
numpad_6Numpad 6No Linux support
numpad_7Numpad 7No Linux support
numpad_8Numpad 8No Linux support
numpad_9Numpad 9No Linux support
leftmouseLeft mouse buttonWindows only
rightmouseRight mouse buttonWindows only
middlemouseMiddle mouse buttonWindows only
x1mouseExtra mouse button 1Windows only
x2mouseExtra mouse button 2Windows only
commaComma (,)Windows only
asteriskAsterisk (*)Windows only
plusPlus (+)Windows only
pipePipe (|)Windows only
minusMinus (-)Windows only
periodPeriod (.)Windows only
slashForward slash (/)Windows only
backslashBackslash (\)Windows only
audio_muteMute volume
audio_vol_downLower volume
audio_vol_upIncrease volume
audio_playPlay
audio_stopStop
audio_pausePause
audio_prevPrevious Track
audio_nextNext Track
audio_rewindRewindLinux only
audio_forwardFast ForwardLinux only
audio_repeatRepeatLinux only
audio_randomShuffleLinux only
stopStop mediaWindows only
playPlay mediaWindows only
launchpadLaunchpad (opens Launchpad)
missioncontrolMission Control
lights_mon_downMonitor brightness downAlias for F14
lights_mon_upMonitor brightness upAlias for F15

Issues or Suggestions?

Report bugs, ask questions, or request new features on GitHub.

Open GitHub Issues