microsoft-presenter-plus

Node.js library for consuming button events from the Microsoft Presenter+ in other programs.

The current scope is intentionally a robust Linux integration via hidraw. Browsers and non-Linux operating systems are not supported at this time.

Installation

npm install microsoft-presenter-plus

Requirements

• Linux
• Node.js 20 or newer
• Access to /dev/hidraw*
• Ideally udevadm for more reliable device discovery

Depending on the system, the calling process may need additional permissions to access the HID device. Without those permissions, discovery or opening the device will fail.

Quick Start

import { MicrosoftPresenter } from "microsoft-presenter-plus";

const presenter = await MicrosoftPresenter.connect();

presenter.on("button", (event) => {
  console.log(event.button, event.action, event.timestamp);
});

presenter.on("error", (error) => {
  console.error("Presenter error:", error);
});

process.on("SIGINT", async () => {
  await presenter.stop();
  process.exit(0);
});

Alternative Usage

If your application wants to control discovery explicitly:

import { discoverPresenter, openPresenter } from "microsoft-presenter-plus";

const device = await discoverPresenter({ debug: true });
const presenter = await openPresenter(device.devicePath);

presenter.on("button", (event) => {
  if (event.button === "mic" && event.action === "press") {
    console.log("Mic pressed");
  }
});

If multiple presenters are possible:

import { listPresenters } from "microsoft-presenter-plus";

const devices = await listPresenters();
console.log(devices);

Example Programs

The repository includes a few small example programs that can be started through npm:

npm run example:list
npm run example:log
npm run example:open-by-path -- /dev/hidrawX

• example:list prints all matching Presenter+ devices
• example:log auto-discovers one device and logs button events
• example:open-by-path opens a specific hidraw device path

API

MicrosoftPresenter.connect(options?)

Automatically finds a matching device, or uses options.devicePath, and starts the reader immediately.

Options:

• devicePath?: string
• debug?: boolean
• reportLength?: number

discoverPresenter(options?)

Returns exactly one detected device. If none or more than one matching device is found, it throws PresenterDiscoveryError.

listPresenters(options?)

Returns all matching Presenter+ devices.

openPresenter(devicePath, options?)

Opens a known device directly and starts the reader.

Events

button:

type PresenterButton = "mic" | "left" | "right" | "light" | "teams";
type PresenterAction = "press" | "release";

interface PresenterEvent {
  button: PresenterButton;
  action: PresenterAction;
  raw: Buffer;
  timestamp: number;
}

error:

Emitted if the device can no longer be read after startup.

Platform Limits

This library currently depends on Linux-specific mechanisms:

• scanning /dev/hidraw*
• reading /sys/class/hidraw
• optionally calling udevadm info

Because of that, the library throws PresenterUnsupportedPlatformError early on non-Linux systems.