Skip to content
qǝʍᴉʍǝp edited this page Mar 2, 2024 · 7 revisions

Welcome to the spacemouse-osc wiki

What is Spacemouse-OSC?

Spacemouse-OSC convert incoming HID data from a 3Dconnexion Spacemouse to OSC. It could help you to control external softwares with your Spacemouse.

Knowledge Base

Spacemouse is a 6DOF device with 3 axes and buttons (number of buttons depends on your Spacemouse). Spacemouse-OSC convert the 6DOF data (x,y,z,yaw,pitch,roll) and buttons (actually the two first ones) to OSC messages. Values of 6DOF are in the range of -1.0 to 1.0, buttons send 1 when pressed and 0 when released. Actually spacemouse-osc send these absolute values as they are. In the future, it will be possible to send relative values.

X axis Y axis Z axis Roll Pitch Yaw
img img img img img img

Install Spacemouse-OSC

Install the latest version of Spacemouse-OSC for your platform (actually support macOS -not tested yet!-, Linux amd64/arm64/armv7l and Windows 64-bit).

How to setup Spacemouse-OSC?

Spacemouse-OSC is a simple and easy-to-use application. You can adjust the settings opening the "Preferences" menu with the top-left button. After the first launch and after each change, the settings are automatically saved in a config.json file in your home directory (usually ~/Documents/spacemouse-OSC on Linux).

Capture d’écran du 2024-03-02 19-14-24