Node.js binding for reading text inputs on Linux, such as barcode scanners.

Features:

• First class TypeScript support
• Node-API addon for better parsing of input_event
• Supports exclusive (EVIOCGRAB) open
• Mocking interface for better unit testing, even on platforms other than Linux

npm install --save hid-input

npm install --save hid-input --build-from-source

Additional build dependencies are required on different platforms:

sudo apt install -y build-essential cmake ninja-build

brew install cmake ninja

import { createInput, listInputs } from 'hid-input';

const inputs = await listInputs();
console.log(inputs);

const reader = createInput(inputs[0].path);
reader.once('open', ()=>{
  console.log('device opened');
});
reader.on('data', (input) => {
  console.log(`- scanned: ${input}`);
});

• Returns: Promise<InputDevice[]>
  • path - string Path to the device
  • name - string Human readable name of the deivce

List HID input devices available on this machine.

• path - string
• options - Object
  • exclusive - boolean Whether to prevent the device from being opened by other processes before getting closed
• Returns: HidInputStream

Opens an input stream of device path. Available devices along with paths can be retrieved with listInputs().

• path - string
• Returns: HidInputStream

Opens a mocking stream by listening on a newly created UNIX domain socket path.

After the stream is open, you can emulate inputs with nc -U <path>.

• Extends fs.Readable

A readable stream in Object mode.

• input - string Input read from the device

Close the stream and release any underlying resources.

MIT License