libfreenect

libfreenect is a userspace driver for the Microsoft Kinect. It runs on Linux, OSX, and Windows and supports

• RGB and Depth Images
• Motors
• Accelerometer
• LED
• Audio

Build Instructions

To build libfreenect, you’ll need

• libusb >= 1.0.18
• CMake >= 2.6
• python == 2.* (only if BUILD_PYTHON=ON or BUILD_REDIST_PACKAGE=OFF)

For the examples, you’ll need

• OpenGL (included with OSX)
• glut (included with OSX)
• pthreads-win32 (Windows)

For audio support, you must have firmware to upload to the Kinect. If you specify a non-redistributable package, firmware will be downloaded automatically:

cmake -L .. -DBUILD_REDIST_PACKAGE=OFF

Note that the downloaded firmware may not be legal to redistribute!

Fetch & Build

git clone https://github.com/OpenKinect/libfreenect
cd libfreenect
mkdir build
cd build
cmake -L ..
make

# if you don't have `make` or don't want color output
# cmake --build .

You can specify a build with debug symbols:

cmake -L .. -DCMAKE_BUILD_TYPE=debug
# or with optimizations
# cmake -L .. -DCMAKE_BUILD_TYPE=RelWithDebInfo

You can build .deb, .rpm, and/or .tgz packages with cpack:

cmake .. -L -DBUILD_CPACK_DEB=ON -DBUILD_CPACK_RPM=ON -DBUILD_CPACK_TGZ=ON
cpack

OSX

If you don’t have a package manager, install Homebrew. For a manual build, see the wiki.

Homebrew

brew install libfreenect
# or get the very latest:
# brew install --HEAD libfreenect

MacPorts

sudo port install git-core cmake libusb libtool

Continue with Fetch & Build.

Linux

For a manual build, see the wiki.

Ubuntu/Debian/Mint

The version packaged in Ubuntu may be very old. To install newer packaged builds, see the wiki. Continue with this section for a manual build.

sudo apt-get install git-core cmake pkg-config build-essential libusb-1.0-0-dev
sudo adduser $USER video
sudo adduser $USER plugdev # necessary?

# only if you are building the examples:
sudo apt-get install libglut3-dev libxmu-dev libxi-dev

Continue with Fetch & Build.

There is also a debian branch for packaging purposes.

Gentoo Linux

There is a live ebuild for your convenience in platform/linux/portage/dev-libs/libfreenect/.

File truncated at 100 lines see the full file