Click.js will detect mouse and keyboard events using a tiny child process and allow you to subscribe to the event loop using Node. It also detects switching between windows and changes made to the clipboard. (Click.js is Windows only)

First an example

Easy as pie!

var clickjs = require('click.js')
var click = new clickjs()

click.on('keyInput', (event) => {
    console.log(event) // event contains details
})

click.start()
setTimeout(() => {
    click.done() // for sake of example, stop listening after 60 seconds
}, 60000)

Require

var clickjs = require('click.js')

Create

var click = new clickjs()

Methods

A clickjs object exists of three methods.

• start()
• done()
• on()

Start

Start listening.

click.start()

Done

Kill the child.

click.done()

On

Subscribe to events.

click.on(type, callback(event))

Types

There are 5 event types with consistent properties.

• keyInput (a key is pressed or released)
• mouseInput (any mouse button is pressed or released)
• clipboardModified (windows clipboard has been overwritten)
• applicationWindowChange (user changed active window)

keyInput

A key on the keyboard is pressed or released.

mouseInput

A mousebutton contains the event (sub)type as well as the coordinates.

clipboardModified

In most cases the user has pressed ctrl+c.

applicationWindowChange

A window is minimized or whatever.

Event loop

Subscribe to events using simple on-method.

mouseInput

Subscribe to all mouse events. Mouse events include button down, button up, scrolling and cursor movement.

click.on('mouseInput', (event) => {
    console.log(event) // event also includes event type
})

Subscribe to other events

Subscribe to any of the 5 event types and console.log the event to see what info that gives you.

Subscribe to all available event types

This will not override the behavior of type specific callbacks but they will both be called.

click.on('*', (event) => {
    // this event can be anything! but not an error
})

Jochem Stoel

Involuntary public figure.