Connect a device

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 device gallery; see Litra lights and Webcams.

Verifying the connection

Open the GUI. Devices appear in the Home gallery, with battery percentage and charge state for online devices. The responsive grid is the default; use the view buttons to switch between grid, list, and carousel layouts. This choice is saved.

Each card's menu lets you set a custom display name. Delete device is available only for an offline saved device; it removes the saved record, custom name, and per-device settings, but does not unpair the hardware from its receiver.

From the CLI, run openlogi list. It prefers a compatible running agent's snapshot, which is the same HID inventory the GUI consumes. If the agent is unreachable, times out, or has an incompatible protocol version, the command says so on stderr and falls back to direct hardware enumeration. That fallback, and openlogi diag hardware commands, use the CLI's own device access rather than the agent's; a successful direct result therefore does not prove that the agent can open the device.

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

The GUI's Add device flow supports Bolt and Unifying receivers:

• Bolt: discovery lists nearby pairable devices. Select one to begin its passkey exchange—for a mouse, a short sequence of left/right clicks.
• Unifying: OpenLogi opens the receiver's pairing lock. Power on one unpaired device in range; it connects without a discovery list or passkey.

Lightspeed receivers are enumerated and driven, but pairing a new device to one is not implemented; use Logitech's pairing tool for that.