MOVIN TRACIN · MOVIN Studio Usage Guide
Streaming Mocap Data over OSC
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.
Download: MOVIN-OSC-Receiver-v3.3.0.zip from the MOVIN OSC Receiver repository.
How to stream over OSC: Step by Step
-
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.
-
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.1if 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.
-
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
| Problem | Check |
|---|---|
| Port already in use | Close any other receiver on that port, or use another port in both apps. |
| Viewer waits for motion | Platform is OSC, streaming is on, and Host, Port Number and the firewall are right. |
| No point cloud | Turn on Point Cloud in MOVIN Studio (Capture only). |
| Dependency or OpenGL error at startup | Activate 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.