OpenLogi

Connect a device

How to connect a Logitech device via receiver, Bluetooth, or USB and verify it appears in OpenLogi.

OpenLogi reaches Logitech HID++ devices over three transports:

  • Receiver — a Logi Bolt, Unifying, or Lightspeed USB receiver; OpenLogi discovers the receiver and lists every paired device. See Receivers for the recognised dongles.
  • Bluetooth-direct — a device paired straight to the computer over Bluetooth, no receiver.
  • Wired — a device connected over USB.

Not everything speaks HID++: Litra lights are driven over raw HID and Logitech webcams over USB Video Class, and both show up in the same carousel; see Lights & webcams.

Verifying the connection

Open the GUI. Connected devices appear in the device carousel, with battery percentage and charge state for online devices. From the CLI, run openlogi list to print the same inventory headlessly.

OpenLogi device carousel listing two paired Logitech mice with battery and connection status

The device carousel: each paired device with its slot, transport, and live battery state.

If a device doesn't show up, confirm Logi Options+ is fully quit (including its background agent) so it isn't holding the receiver. On Linux, quit Solaar and check the GUI's Settings → Permissions page: the udev rules must be installed for /dev/hidraw* access (see Installation).

Pairing a new device

A Bolt receiver can pair new devices from the GUI's Add device flow: discovery lists nearby pairable devices, and confirming one starts the passkey exchange Bolt requires: for a mouse, a short sequence of left/right clicks. Unifying and Lightspeed receivers are enumerated and driven, but pairing new devices to them is not implemented; use Logitech's own pairing tool for those.

On this page