VICREO Listener

made with python repo size current release

Hotkey listener for windows & Mac

Latest Windows release Latest OSX release

Go to VICREO releases for download.

VICREO Listener is a small program that sits on your machine waiting for incomming TCP connection/commands. It uses pre-defined commands to simulate keypresses on your machine. You can use this program to preform hotkey actions from remote

Controllable by Companion


Download the right software package for your operating system and launch the program on the machine you would like to control (host).

On your client machine (the one you are sending commands from), send TCP string to the right IP-address from the host, to port 10001


Below you’ll find a table of pre-installed commands that the listener will accept. Firt tell the program what kind of key you are going to send and than the key itself.

Action Description Example
<SK> Single key <SK>n
<KCOMBO> <AND> Key combination <KCOMBO>alt<AND>tab
<KTRIO> <AND> <AND2> Key trio combination <KCOMBO>ctrl<AND>shift<AND2>d
<KPRESS> Simulates key down <KPRESS>n
<KRELEASE> Simulates key up <KRELEASE>n
<MSG> Send message <MSG>Hello World (only string message)
<FILE> Open file (complete path) <FILE>c:\user\test\test.bat

The <KPRESS> and <KRELEASE> can be used for special cases, Example;

but above is the same as <KCOMBO>ctrl<AND>c

Be aware there is a limit of 160 bytes to receive, this because of the <MSG> function

Make sure you use the backslash in the file open command


The following modifier are supported:

alt ctrl tab shift cmd alt_gr delete backspace space caps_lock end enter esc f1 f2 f3 f4 f5 f6 f7 f8 f9 f10 f11 f12 home insert (only windows) left right up down num_lock (only windows) page_up page_down


For mac, when you need the path of a file, right-click on the file and when you see the menu, press and hold Alt to be able to copy the full path.

For additional actions, please raise a feature request on GitHub.