Installation

The simplest way to install cwipc is to use one of the pre‑built installers. Installers are provided for macOS, Windows and Ubuntu and bundle all of the runtime libraries, command‑line tools and language bindings.

Note

After installing, running cwipc view --synthetic should open a window showing a synthetic point cloud stream (a rotating paraboloid with blinking eyes). You can also run cwipc_check to verify the installation and dependencies, it will print any warnings or errors it finds.

macOS

Use Homebrew:

brew tap cwi-dis/cwipc
brew install cwipc

Windows

Download the .exe installer from the releases page and execute it. If the installer refuses to run, install the Microsoft VC++ Redistributable (x64) first.

After installation, use the Start menu entries to run Check cwipc installation and optionally Attempt to fix cwipc installation.

The top-level readme file has some more Windows Installation troubleshooting tips.

Ubuntu 24.04

Install the Debian package:

sudo apt install ./cwipc-<version>.deb

Realsense drivers are not included; inspect /usr/share/cwipc/scripts/install-3rdparty-ubuntu2404.sh for instructions.

Android

The Android build is API‑only and used primarily from Unity on Quest devices.

From source

If you require a custom build or want to contribute, follow the instructions in Building from source.