Documentation

  2. Home
  4. Docs
  6. Getting Started
  8. Installation – Linux CPU

Installation – Linux CPU

LightBuzz proudly supports Ubuntu Linux 18.04 LTS and 20.04 LTS. To use our software on Linux, you need to perform some additional installation steps.

Hardware requirements

The LightBuzz Body Tracking SDK requires hardware acceleration. To use hardware acceleration on Linux, you need an Intel CPU. The more performant the CPU, the higher the frame rate of the LightBuzz SDK will be. As long as you have an Intel processor, you can move on to the installation steps.

Unity3D

Unity3D supports Ubuntu. Go to the Unity website and click the Download Unity Hub button.

A window will open to ask if you want to save the file. Select Save File and OK. This will save the file in the Downloads folder.

Open your terminal, navigate to the Downloads folder and run the following command:

cd ~/Downloads
chmod +x UnityHub.AppImage

Go to the Downloads folder and double-click the UnityHub.AppImage. This should open the Unity Hub. Go to the Installs and click the Add button. Select the latest Unity LTS version and click Next.

Unity3D for Ubuntu - LTS installation

Select the Linux Build Support with the IL2CPP scripting backend (optional) and click Done.

Unity3D for Ubuntu - Linux Build Support (IL2CPP)

Intel RealSense [OPTIONAL]

If you intend to use the Intel RealSense cameras, you need to install the official RealSense packages, too.

Go to Github and find the v2.47.0 RealSense release. Select the source code (zip). A window will open to ask if you want to save the file. Select Save File and OK.

Go to the Downloads folder and unzip the file.

Then, open a terminal and copy the file to usr/local:

cd ~/Downloads/
sudo cp -r librealsense-2.47.0 /usr/local

Navigate to the librealsense root directory and run the following scripts:

cd /usr/local/librealsense-2.47.0
sudo apt-get install git libssl-dev libusb-1.0-0-dev pkg-config libgtk-3-dev
sudo apt-get install libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev

Install the Intel Realsense permission scripts.

sudo cp config/99-realsense-libusb.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && udevadm trigger

Build and apply patched kernel modules.

sudo ./scripts/patch-realsense-ubuntu-lts.sh

Update the build toolchain.

sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update

Create a build folder, build and install binaries.

sudo mkdir build && cd build
sudo cmake ../ -DCMAKE_BUILD_TYPE=Release
sudo make install

Connect your RealSense camera and run the RealSense Viewer app to ensure the packages were installed correctly.

realsense-viewer

LightBuzz Binaries – Local

Developer computers need to have the LightBuzz binaries next to the Assets folder. Download the LightBuzz Binaries for Linux, unzip the folder, and copy all of its contents next to the Assets folder of your project. Every time you create a new project in Unity3D, go to the root folder and copy all of the above dependencies right next to the Assets folder, as seen below:

LightBuzz Body Tracking SDK for Linux - Binaries

You can now run body-tracking scenes directly in the Unity Editor.

Building your project

Whenever it’s time to build your project, select LightBuzz →Apply Build Settings for → Linux.

Then, build the project normally.

When finished, navigate to the build folder and open the [PROJECT_NAME]_Data/Plugins folder.

Finally, copy the above binaries inside the Plugins folder and run the program.

How can we help?