rolfmorel / spacemouse

A command-line utility for 3D/6DoF input devices

spacemouse

A command-line utility for 3D/6DoF input devices.

With commands for:

• retrieving information about connected 6DoF devices
• retrieving, setting and switching the LED state of connected 6DoF devices
• recieving events on connected 6DoF devices (device, motion and button events)
• testing/debugging (of libspacemouse)

Currently supported devices

3Dconnexion USB human interface devices:

• SpaceExplorer
• SpaceNavigator
• etc.

Usage

$ spm list
devnode: /dev/input/event4
manufacturer: 3Dconnexion
product: SpaceNavigator

devnode: /dev/input/event0
manufacturer: 3Dconnexion
product: SpaceExplorer

---

$ spm led
/dev/input/event4: off
/dev/input/event0: off

---

$ spm led on

---

$ spm led --devnode /dev/input/event4 switch
/dev/input/event4: switched off

---

$ spm event
motion: forward
motion: forward
motion: right
motion: down
motion: up
button: 1 press
button: 1 release
button: 0 press
button: 0 release
device: /dev/input/event4 3Dconnexion SpaceNavigator disconnect
device: /dev/input/event4 3Dconnexion SpaceNavigator connect
button: 0 press
button: 0 release
...

---

$ spm raw
device id: 1
  devnode: /dev/input/event4
  manufacturer: 3Dconnexion
  product: SpaceNavigator
device id: 2
  devnode: /dev/input/event0
  manufacturer: 3Dconnexion
  product: SpaceExplorer
device id 1: got motion event: t(-1, -19, 0) r(0, 0, 0) period(0)
device id 1: got motion event: t(-7, 0, 10) r(0, 0, 0) period(16)
device id 1: got motion event: t(-7, 0, 10) r(-29, 0, -14) period(8)
device id 1: got motion event: t(0, -129, 0) r(-29, 0, -14) period(8)
device id 1: got motion event: t(0, -129, 0) r(-37, 0, -111) period(8)
device id 1: got motion event: t(-33, -44, 41) r(-37, 0, -111) period(8)
device id 1: got motion event: t(-33, -44, 41) r(-81, 0, -109) period(8)
device id 1: got motion event: t(-12, -125, 60) r(-81, 0, -109) period(8)
device id 1: got motion event: t(-12, -125, 60) r(-105, 0, -122) period(8)
...
device id 1: got button press event b(1)
device id 1: got button release event b(1)
...

Build

Dependencies

• libspacemouse

Compile and install

make
sudo make install

Uninstall

sudo make uninstall

Examples

• cli examples:
  some examples of how the different commands can be used, including selecting devices, led switching in a loop and filtering of events

• simple led deamon:
  simple script for turning the LED on on device connect

• simple key map:
  script for mapping events to keys with xdotool, for example: scrolling, zooming and killing applications