Skip to content
RobothecaBeta
Log in

PySpaceMouse

  • Software
  • Humanoids and robot learning
  • Library

A Python library that reads 3Dconnexion SpaceMouse devices directly over raw HID, without needing the vendor drivers or software. Used for teleoperation and robot control.

Source on GitHub: github.com/JakubAndrysek/PySpaceMouse (opens in a new tab). Facts read at commit 46fa35a (opens in a new tab).

Licenses

Code
MIT (opens in a new tab)

Read by Robotheca from LICENSE (opens in a new tab) (MIT) at commit 46fa35a (opens in a new tab), on 16 Oct 2026.

Commercial use
Yes

What it does

  • Reads six-axis translation and rotation values plus button states from SpaceMouse devices.
  • Works without installing 3Dconnexion drivers, talking to the controller directly through hidapi.
  • Auto-detects connected devices, or opens a specific device by name, index or path.
  • Supports button and per-axis callbacks with deadzone filtering and rate limiting.
  • Offers axis convention options and custom axis remapping or inversion for different coordinate frames.
  • Includes a command-line tool to list connected, supported and HID devices and to test the connection.

Written by Robotheca from the project's README (opens in a new tab) at commit 46fa35a.

Getting started

Difficulty
Beginner
Hardware it needs, as the project states it
On Linux, read access to the device may need a udev rule for vendor ID 256f; installation via pip pulls in hidapi, which needs nothing else on Linux, macOS or Windows.

Maintenance

Status
Active: a commit in the last 90 days
Newest commit
23 Aug 2026 on master
Latest release
2.1.0 (19 Aug 2026)

Checked on GitHub on 16 Oct 2026.

Links

Robots that can run it

No robot on Robotheca is linked to it yet. Links come from a robot's robot.yaml, from its dependency files read as text, or from Robotheca's editors.

Robotheca lists software as a reference: nothing is hosted or run here, and every fact links to where it was read.