VICREO-Listener

VICREO Listener

Hotkey listener for windows, Mac and Linux

Go to VICREO releases for download.

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

Controllable by Companion

Donation

Please consider a small donation if you are using this product on your productions and like it. It will help me collect some money for the yearly certificates from Apple and Windows (which cost over $300);

Installation

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 (or change the port to something you like)

Usage

You’ll send an object to the listener. The application first looks a key called type.

The following types are available;

Example key press

For keypresses create a object like this;

{ "key":"tab", "type":"press", "modifiers":["alt"] }

Put the modifiers in an array. Alt/option, command(win), Ctrl and Shift are supported.

Example open file

Open a file on the local system;

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

Example shell

To perform a shell command on the system;

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

Example processOSX

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

Keys

The following keys are supported:

Key Description Notes
backspace    
delete    
enter    
tab    
escape    
up Up arrow key  
down Down arrow key  
right Right arrow key  
left Left arrow key  
home    
end    
pageup    
pagedown    
f1    
f2    
f3    
f4    
f5    
f6    
f7    
f8    
f9    
f10    
f11    
f12    
command    
alt    
control    
shift    
right_shift    
space    
printscreen   No Mac support
insert   No Mac support
audio_mute Mute the volume  
audio_vol_down Lower the volume  
audio_vol_up Increase the volume  
audio_play Play  
audio_stop Stop  
audio_pause Pause  
audio_prev Previous Track  
audio_next Next Track  
audio_rewind   Linux only
audio_forward   Linux only
audio_repeat   Linux only
audio_random   Linux only
numpad_0   No Linux support
numpad_1   No Linux support
numpad_2   No Linux support
numpad_3   No Linux support
numpad_4   No Linux support
numpad_5   No Linux support
numpad_6   No Linux support
numpad_7   No Linux support
numpad_8   No Linux support
numpad_9   No Linux support
lights_mon_up Turn up monitor brightness No Windows support
lights_mon_down Turn down monitor brightness No Windows support
lights_kbd_toggle Toggle keyboard backlight on/off No Windows support
lights_kbd_up Turn up keyboard backlight brightness No Windows support
lights_kbd_down Turn down keyboard backlight brightness No Windows support

FAQ

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. Fill complete filepath without parentheses


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

NOTES ON BUILDING

For OSX Building you need a valid Developer certificate, which you can only get from signing up for Apple’s developer program. Install Developer ID Application certificate in your keychain, by creating a new certificate and downloading/open it in keychain run <pre>security find-identity -vp codesigning </pre> to check if the certificate can be found by electron. Change the identity in <pre>forge.config.js</pre> to your own certificate. For CI Build do a <pre>base64 -i name.p12 -o output.txt</pre> To check if the build is signed correctly do this;

spctl -a -vv '/Users/user/projects/VICREO-Listener/out/make/zip/darwin/x64/VICREO-Listener.app'</pre>