ContactGlove Python SDK V2

English | 日本語

Receive ContactGlove3 Pro data from DivingStation over OSC. The SDK provides polling and callbacks for glove, ergonomics, skeleton, sensor, and controller data, and supports haptic requests.

Requirements

• Python 3.10 or later; operation has been confirmed on Windows 11, macOS, and Ubuntu.
• ContactGlove3 Pro and a running DivingStation installation. Configure and approve the connection in DivingStation.
• python-osc>=1.7.5 and matplotlib>=3.7.5 are installed automatically; matplotlib is used by the viewer example.

Installation

From PyPI

python -m pip install contactglovesdk

From a distribution ZIP

Extract the distribution and install its bundled wheel, replacing X.Y.Z with its version:

python -m pip install ./contactglovesdk-X.Y.Z-py3-none-any.whl

Receive data

Start DivingStation and connect the glove first. This example assumes DivingStation is on the same machine and uses its default OSC port. Approve the connection in DivingStation if prompted. Press Ctrl+C to stop.

import time
from contactglovesdk import ContactGloveClient, Host

host = Host("DivingStation", "127.0.0.1", 25791)
with ContactGloveClient() as client:
    client.register_callback_for_glove_data_stream(print)
    client.connect_to_host(host)
    try:
        while True:
            time.sleep(1)
    except KeyboardInterrupt:
        pass
    finally:
        client.disconnect(host)

Documentation and support

• Setup, usage and troubleshooting
• API reference
• Contact support
• Development guide

The customer distribution also includes the API reference and license documents in its doc/ folder.

License

The SDK is licensed under Apache License 2.0. See NOTICE and third-party notices for attribution and dependency licenses.