Skip to content

MOVIN TRACIN · MOVIN Studio Usage Guide

Streaming Mocap Data over OSC

On this page

Goal of this chapter: Motion (and optionally point clouds) from MOVIN Studio arrives in your own OSC receiver.

The OSC target sends your actor or character over OSC/UDP, for any app or code that reads OSC. To check the stream - or as a starting point for your own receiver - use the MOVIN OSC Receiver & Viewer (Python).

For ROS 2, see Streaming Mocap Data into ROS by OSC. For Python code, see the MOVIN SDK Python.

Before you start

  • Using the free Basic License? Streaming to OSC from Capture needs an Unlimited License.
  • For the viewer: Windows and Python 3.11 are recommended, with an OpenGL-capable display. MOVIN Studio v3.3.0 or later shows its connection status and FPS.

How to stream over OSC: Step by Step

  1. Set up and run the viewer

    • Extract the ZIP and open a terminal in that folder.
    • Install the dependencies with one of these:
    # Conda
    conda env create -f environment.yml
    conda activate movin-osc
    
    # Python venv
    python -m venv .venv
    .venv\Scripts\Activate.ps1
    pip install -r requirements.txt
    
    • Run the viewer. It listens on port 11235:
    python main.py
    
    • To use another port: python main.py --port 11236.
  2. Stream from MOVIN Studio

    • Choose what to stream: select your actor, or double-click a character in the Characters tab.
    • In the Streaming section of the bottom panel, click ⚙ to open the streaming settings.
    • Set Platform to OSC. The Port Number changes to 11235.
    • Set Host to 127.0.0.1 if the receiver runs on the same PC, or to the IPv4 address of the receiver PC.
    • Under Additional Data, turn on Hand and Point Cloud if you need them.
    • Click Stream. The status shows On, and OSC: connected once the viewer answers.
  3. Check the stream in the viewer

    • The viewer shows each character's name, bone count and received motion FPS, plus the point count, point cloud FPS and viewer FPS.
    • Controls: left-drag to rotate, wheel to zoom, R to reset the camera, Up / Down to move the camera target, Esc to close.

Troubleshooting

ProblemCheck
Port already in useClose any other receiver on that port, or use another port in both apps.
Viewer waits for motionPlatform is OSC, streaming is on, and Host, Port Number and the firewall are right.
No point cloudTurn on Point Cloud in MOVIN Studio (Capture only).
Dependency or OpenGL error at startupActivate the right Python environment, install the requirements, and check the graphics driver.

Streaming to another PC? Allow UDP 11235 (or your port) into the receiver PC, and UDP 39581 into MOVIN Studio for the connection status.