A modern Python 3-compatible wrapper for libfreenect, providing access to Microsoft Kinect v1 functionality.
⚠️ This project builds upon the original Python wrapper by Brandyn White(https://github.com/bwhite). I have ported and updated it for Python 3 compatibility and ongoing maintenance.
You can now install the package directly from PyPI:
pip install freenectClone the repository and install manually:
git clone https://github.com/dewminawijekoon/freenect-python.git
cd freenect-python
pip install .To install in editable mode with development dependencies:
git clone https://github.com/dewminawijekoon/freenect-python.git
cd freenect-python
pip install -e ".[dev]"Make sure libfreenect is installed on your system before using this wrapper.
Follow the official instructions: 👉 https://github.com/OpenKinect/libfreenect
import freenect
import numpy as np
# Capture a depth image
depth, timestamp = freenect.sync_get_depth()
print(f"Depth shape: {depth.shape}")
# Capture an RGB image
rgb, timestamp = freenect.sync_get_video()
print(f"RGB shape: {rgb.shape}")- Access Kinect depth and RGB video streams
- Synchronous & asynchronous capture modes
- Seamless integration with NumPy
- Cross-platform support (Linux, macOS, Windows)
- Python 3.8+
- NumPy
- libfreenect (installed system-wide)
Licensed under the Apache License 2.0.
Contributions are welcome! Feel free to open issues, fork the repo, or submit pull requests.
Encounter a problem? Open an issue and include a detailed description to help us assist you better.