pyorbbecsdk (Forked)

This repository is a fork of orbbec/pyorbbecsdk, rewritten to add CI automated builds and simplified deployment.

Install directly from PyPI:

pip install pyorbbecsdk-community

Contributors

_{Chris Paxton}
💻

_{Lukas Koestler}
💻

_{David Millard}
💻

_{nikita-azalea}
💻

_zhonghong322
💻

_{William Yan}
💻

_{Joe Dong}
💻

Note: This is a community maintained fork. For any issues or feature requests, please open an issue on this repository.

From here onward, the content is from the original repository's README.

Python Bindings for Orbbec SDK

This main branch provides Python bindings for the Orbbec SDK v1.x, allowing developers to interface with Orbbec devices in Python. the OrbbecSDK_V2.x branch provides Python bindings for the Orbbec SDK v2.x,The differences between Orbbec SDK v2.x and Orbbec SDK v1.x can be found in the README.

Important

Welcome to the python wrapper . Before you begin using this version of python wrapper , it's crucial to check the following device support list to verify the compatibility.

Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):

Product Series	Product	Branch main	Branch v2-main
Gemini 330	Gemini 335	full maintenance	recommended for new designs
	Gemini 336	full maintenance	recommended for new designs
	Gemini 330	full maintenance	recommended for new designs
	Gemini 335L	full maintenance	recommended for new designs
	Gemini 336L	full maintenance	recommended for new designs
	Gemini 330L	full maintenance	recommended for new designs
	Gemini 335Lg	not supported	recommended for new designs
Gemini 2	Gemini 2	full maintenance	recommended for new designs
	Gemini 2 L	full maintenance	recommended for new designs
	Gemini 2 XL	recommended for new designs	to be supported
Femto	Femto Bolt	full maintenance	recommended for new designs
	Femto Mega	full maintenance	recommended for new designs
	Femto Mega I	full maintenance	to be supported
Astra	Astra 2	full maintenance	recommended for new designs
	Astra+	limited maintenance	not supported
	Astra Pro Plus	limited maintenance	not supported
Astra Mini	Astra Mini Pro	full maintenance	not supported

Note: If you do not find your device, please contact our FAE or sales representative for help.

Definition:

recommended for new designs: we will provide full supports with new features, bug fix and performance optimization;
full maintenance: we will provide bug fix support;
limited maintenance: we will provide critical bug fix support;
not supported: we will not support specific device in this version;
to be supported: we will add support in the near future.

Hardware Products Supported by Python SDK

products list	firmware version
Gemini 330	1.2.20
Gemini 330L	1.2.20
Gemini 335	1.2.20
Gemini 335L	1.2.20
Gemini 336	1.2.20
Gemini 336L	1.2.20
Femto Bolt	1.0.6/1.0.9
Femto Mega	1.1.7/1.2.7
Gemini 2 XL	Obox: V1.2.5 VL:1.4.54
Astra 2	2.8.20
Gemini 2 L	1.4.32
Gemini 2	1.4.60 /1.4.76
Astra+	1.0.22/1.0.21/1.0.20/1.0.19
Femto	1.6.7
Femto W	1.1.8
DaBai	2436
DaBai DCW	2460
DaBai DW	2606
Astra Mini Pro	1007
Gemini E	3460
Gemini E Lite	3606
Gemini	3.0.18
Astra Mini S Pro	1.0.05

Getting Started

Get the Source Code

Clone the repository to get the latest version of the Python bindings for Orbbec SDK.

git clone https://github.com/orbbec/pyorbbecsdk.git

Install Dependencies

Install the necessary Python development packages on Ubuntu.

sudo apt-get install python3-dev python3-venv python3-pip python3-opencv

Custom Python3 Path (Optional)

If you use Anaconda, set the Python3 path to the Anaconda path in pyorbbecsdk/CMakeLists.txt before the find_package(Python3 REQUIRED COMPONENTS Interpreter Development) line:

set(Python3_ROOT_DIR "/home/anaconda3/envs/py3.6.8") # Replace with your Python3 path
set(pybind11_DIR "${Python3_ROOT_DIR}/lib/python3.6/site-packages/pybind11/share/cmake/pybind11") # Replace with your Pybind11 path

Build the Project

Create a virtual environment and build the project.

cd pyorbbecsdk
python3 -m venv ./venv
source venv/bin/activate
pip3 install -r requirements.txt
mkdir build
cd build
cmake -Dpybind11_DIR=`pybind11-config --cmakedir` ..
make -j4
make install

Try the Examples

Set up your environment to run examples and install necessary system rules.

cd pyorbbecsdk
export PYTHONPATH=$PYTHONPATH:$(pwd)/install/lib/
sudo bash ./scripts/install_udev_rules.sh
sudo udevadm control --reload-rules && sudo udevadm trigger
python3 examples/depth_viewer.py
python3 examples/net_device.py # Requires ffmpeg installation for network device

Additional examples are available in the examples directory. Please see examples/README.md for further details.

Generate Stubs

Generate Python stubs for better IntelliSense in your IDE.

source env.sh
pip3 install pybind11-stubgen
pybind11-stubgen pyorbbecsdk

Building on Windows

For instructions on how to build and run the examples on Windows, please refer to docs/README.md.

Making a Python Wheel

Generate a wheel package for easy distribution and installation.

cd pyorbbecsdk
python3 -m venv ./venv
source venv/bin/activate
pip3 install -r requirements.txt
mkdir build
cd build
cmake -Dpybind11_DIR=`pybind11-config --cmakedir` ..
make -j4
make install
cd ..
pip3 install wheel
python3 setup.py bdist_wheel
pip3 install dist/*.whl

Enabling Device Timestamps via UVC Protocol on Windows

To get device timestamps through the UVC protocol on a Windows system, you must modify the registry by completing a registration process. This is required due to default system limitations. Follow the steps below to configure your system:

1. Connect the Device

Ensure your UVC-compatible device is connected to the computer and recognized by the system. Confirm that the device is online and functioning.

2. Open PowerShell with Administrator Privileges

Open the Start menu, type PowerShell, right-click on the PowerShell app, and select 'Run as administrator'.

3. Navigate to the Scripts Directory

Use the cd command to change the directory to the location of your scripts.
```
cd scripts
```

4. Modify Execution Policy

Modify the PowerShell execution policy to allow script execution. Run the following command and press Y when prompted to confirm the change:
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```

5. Execute the Registration Script

Run the registration script to modify the registry settings. Use the following command:
```
.\obsensor_metadata_win10.ps1 -op install_all
```

This will complete the necessary registration and modification of settings to allow device timestamps via the UVC protocol on your Windows system.

Documentation

For detailed documentation, please refer to docs/README.md.

License

This project is licensed under the Apache License 2.0.

Name		Name	Last commit message	Last commit date
Latest commit History 304 Commits
.github/workflows		.github/workflows
cmake		cmake
config		config
docs		docs
examples		examples
scripts		scripts
sdk		sdk
src/pyorbbecsdk		src/pyorbbecsdk
stubs		stubs
test		test
.all-contributorsrc		.all-contributorsrc
.clang-format		.clang-format
.gitignore		.gitignore
.make_deb.sh		.make_deb.sh
99-obsensor-libusb.rules		99-obsensor-libusb.rules
CMakeLists.txt		CMakeLists.txt
LICENSE		LICENSE
README.md		README.md
env.sh		env.sh
package.xml		package.xml
pyproject.toml		pyproject.toml
setup.py		setup.py

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

pyorbbecsdk (Forked)

Contributors

Note: This is a community maintained fork. For any issues or feature requests, please open an issue on this repository.

Python Bindings for Orbbec SDK

Hardware Products Supported by Python SDK

Getting Started

Get the Source Code

Install Dependencies

Custom Python3 Path (Optional)

Build the Project

Try the Examples

Generate Stubs

Building on Windows

Making a Python Wheel

Enabling Device Timestamps via UVC Protocol on Windows

1. Connect the Device

2. Open PowerShell with Administrator Privileges

3. Navigate to the Scripts Directory

4. Modify Execution Policy

5. Execute the Registration Script

Documentation

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

pyorbbecsdk (Forked)

Contributors

Note: This is a community maintained fork. For any issues or feature requests, please open an issue on this repository.

Python Bindings for Orbbec SDK

Hardware Products Supported by Python SDK

Getting Started

Get the Source Code

Install Dependencies

Custom Python3 Path (Optional)

Build the Project

Try the Examples

Generate Stubs

Building on Windows

Making a Python Wheel

Enabling Device Timestamps via UVC Protocol on Windows

1. Connect the Device

2. Open PowerShell with Administrator Privileges

3. Navigate to the Scripts Directory

4. Modify Execution Policy

5. Execute the Registration Script

Documentation

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages