Private alpha setup

Install KinectVision locally.

The installer is user-local and reviewable. It does not silently install packages, enable persistence, or change the default microphone.

Tester quick start

Known-good testing so far is Ubuntu 24.04 with Kinect v2 and existing PipeWire/PulseAudio system audio. GPU acceleration is not required for the KinectVoice global microphone path.

Prerequisites

  • Kinect v2 sensor
  • Kinect v2 PC adapter and power
  • Linux system; Ubuntu 24.04 is the known-good baseline
  • USB 3.0 port with a stable USB 3.0 controller
  • Existing PipeWire/PulseAudio audio session
  • pactl available; on Ubuntu it is usually provided by pulseaudio-utils

Installer behavior

  • The installer does not silently install packages.
  • The installer does not silently change the default microphone.
  • The raw Kinect mic, built-in audio, and other microphones are not deleted or disabled.
  • Rollback commands are included below.

Recommended first commands

tar -xzf KinectVision-runtime-v1.4.5-alpha.tar.gz
cd KinectVision-runtime-v1.4.5-alpha
./install/install_kinectvision.sh
~/KinectVision-runtime/kinectvoicectl first-run-test
~/KinectVision-runtime/kinectvoicectl status

Optional global mic commands

~/KinectVision-runtime/kinectvoicectl enable-global-mic
~/KinectVision-runtime/kinectvoicectl start
~/KinectVision-runtime/kinectvoicectl status
~/KinectVision-runtime/kinectvoicectl make-default

Only run make-default if you want Linux apps to prefer KinectVoice Beamformed Mic as the input source.

Rollback

~/KinectVision-runtime/kinectvoicectl restore-default
~/KinectVision-runtime/kinectvoicectl disable-global-mic
~/KinectVision-runtime/kinectvoicectl disable-persistence

1. Extract and install

tar -xzf KinectVision-runtime-v1.4.5-alpha.tar.gz
cd KinectVision-runtime-v1.4.5-alpha
./install/install_kinectvision.sh

2. First-run test

~/KinectVision-runtime/kinectvoicectl first-run-test

This checks Kinect microphone capture, input gain, beamforming output, event JSON, and speech detection diagnostics.

3. Enable the global mic

~/KinectVision-runtime/kinectvoicectl enable-global-mic
~/KinectVision-runtime/kinectvoicectl start
~/KinectVision-runtime/kinectvoicectl status

Expected result: KinectVoice Beamformed Mic appears, live processing runs, and your default mic remains unchanged.

4. Optional default microphone

~/KinectVision-runtime/kinectvoicectl make-default
~/KinectVision-runtime/kinectvoicectl restore-default

Only run this if you are comfortable temporarily changing your default input device.

5. Optional persistence

~/KinectVision-runtime/kinectvoicectl enable-persistence
~/KinectVision-runtime/kinectvoicectl enable-persistence --default
~/KinectVision-runtime/kinectvoicectl disable-persistence

Persistence uses a user-level systemd service. The --default form reapplies KinectVoice as the default mic after login.