Go Back   HomeSeer Message Board > Ultilities (Plug-ins) > Utilities Discussion > Keyboard and Mouse Sensor Plug-in (3P)

Keyboard and Mouse Sensor Plug-in (3P) Keyboard / Mouse plug-in

Closed Thread
Thread Tools Display Modes
Old January 26th, 2015, 07:08 PM
spud's Avatar
spud spud is online now
Join Date: Jan 2012
Location: Canada
Posts: 5,133
Keyboard and Mouse Sensor plug-in - HS3 User Guide


System Requirements:

This plugin is for HS3 or HS3PRO. It works only on Windows for now.
It is designed to allow HomeSeer to detect any mouse or keyboard activity on a local or a remote computer.

Plugin Installation on your HS3 Machine:
Download and install from the updater (Utilities section) or download package from the Beta Testing thread and follow instructions to install.

Plugin Installation on a remote Windows computer:
To install on a remote computer, you need first to install it on your HS3 machine, even if you don't want to use it on your HS machine you need to have it installed there (but you don't have to enable it) so that HS3 doesn't complain about licensing issue when you start your remote instances.

1.Download the remote install archive from https://www.dropbox.com/s/alnpm3avjg...0-0-6.zip?dl=0 and unizip it wherever you want on your remote computer.

2. edit the run.bat script with a text editor

3. replace
- <absolute_path_of_exe> with the absolute path of the directory where you installed the plugin
- <ip_of_your_hs_machine> with the actual IP of your HS3 machine
- <instance_name> with a name for this instance of the plugin (no space or special characters).

optionally change other parameters:
- console is an optional parameter that hides the console window when set to false
- autoreconnect is an optional parameter which makes the plugin automatically reconnect when the connection with HS is lost. It can be useful for example when you want to restart HS without having to restart all the remote plugins manually. <seconds_to_wait> is the number of seconds to wait before the plugin tries to reconnect.

here is for example how my run.bat looks like:

C:\KMS\HSPI_KMS.exe server= instance=office autoreconnect=120 console=true
Plugin Configuration:

Go to the config page 'PLUG-INS > KMS > Config - InstanceName', you should see a page like on the screenshot below.
Name:  configlocalinstance.png
Views: 88
Size:  31.2 KB

The Inactivity Delay is the number of seconds after which the KMS device will be set to off, if no mouse movement or keyboard stroke is detected.

You can enable or disable Mouse Sensor / Keyboard Sensor if you only want to monitor one of them or if you want to disable them both (for example if the instance running on your HS3 machine does not have any keyboard or mouse)

"Check other instances every X seconds" is a setting that will only appear for your local instance, it allows to monitor the state of the other remote KMS instances. For example let's say you have a laptop on which you run the KMS plugin remotely, if you shutdown the laptop, the corresponding KMS device in HS3 will not switch to off immediately because the KMS plugin is not running anymore, but it will be set to Off by the local instance next time it checks if the remote plugin is still running.

Last edited by spud; December 7th, 2017 at 03:43 PM.
Old January 27th, 2015, 10:29 AM
spud's Avatar
spud spud is online now
Join Date: Jan 2012
Location: Canada
Posts: 5,133

After starting one or multiple instances of the plugin you should now see one "Keyboard and Mouse Sensor" device for each instance. The name of this device is by default the name of the computer on which the instance is running but you can rename it to anything you want.

Name:  device.jpg
Views: 422
Size:  48.7 KB

The On/Off status of this device will reflect the mouse and keyboard activity of this computer, i.e. status will be set to "On" as soon as it detects a mouse movement/click or a key stroke on the keyboard, and will be set back to "Off" after X seconds of inactivity, by default X is 60 seconds but that can be changed from the plugin config page:

Then you can use this device as an occupancy sensor. For example below are some events I use to turn on the lights in my office at night as soon as I move the mouse of my desktop PC or hit a key, and turn them off after 3 minutes of inactivity.

Name:  occupancy_event.jpg
Views: 413
Size:  103.4 KB

Last edited by spud; August 3rd, 2017 at 09:44 AM.
Old January 29th, 2015, 05:29 PM
spud's Avatar
spud spud is online now
Join Date: Jan 2012
Location: Canada
Posts: 5,133

This plugin is also capable of detecting keyboard shortcuts to trigger events.
To do so, create an event, select "Keyboard and Mouse Trigger", then select "Keyboard Shortcut" as the Trigger Type, then select the combination of key you want.

for example the event in the screenshot below turn some lights on if I press "Ctrl + L" on my keyboard

Name:  shortcut.jpg
Views: 415
Size:  48.3 KB

see this link for more information about the keys name
Closed Thread


keyboard, mouse, occupancy

Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Keyboard and Mouse Sensor - Feature Requests spud Keyboard and Mouse Sensor Plug-in (3P) 6 June 17th, 2018 12:30 AM
Keyboard and Mouse Sensor plug-in - HS2 User Guide spud Keyboard and Mouse Sensor Plug-in (3P) 31 September 2nd, 2015 12:09 AM
Keyboard and Mouse Sensor plug-in - HS3 Beta testing spud Keyboard and Mouse Sensor Plug-in (3P) 7 August 14th, 2015 08:57 AM
Keyboard and Mouse Sensor plug-in - HS2 Beta Testing spud Keyboard and Mouse Sensor Plug-in (3P) 0 May 16th, 2013 06:18 PM
BC4 Plug-In User's Guide BitWise_Mark Bitwise Controls BC4 2 October 16th, 2010 06:23 PM

All times are GMT -4. The time now is 03:58 PM.

Copyright HomeSeer Technologies, LLC