{"id":39133644,"url":"https://github.com/orbbec/pyorbbecsdk","last_synced_at":"2026-02-13T15:28:20.562Z","repository":{"id":188427030,"uuid":"677316969","full_name":"orbbec/pyorbbecsdk","owner":"orbbec","description":"OrbbecSDK python binding","archived":false,"fork":false,"pushed_at":"2025-10-28T09:56:43.000Z","size":346469,"stargazers_count":226,"open_issues_count":130,"forks_count":66,"subscribers_count":3,"default_branch":"v2-main","last_synced_at":"2026-01-25T15:07:10.774Z","etag":null,"topics":["3d","camera","camera-api","computer-vision","depth-camera","developer-kits","hardware","sdk-python"],"latest_commit_sha":null,"homepage":"https://orbbec.github.io/pyorbbecsdk/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/orbbec.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-08-11T09:12:57.000Z","updated_at":"2026-01-23T05:37:11.000Z","dependencies_parsed_at":"2023-10-12T23:53:11.924Z","dependency_job_id":"6f99d0cf-72ce-4234-a7a5-5c45e29ca8f9","html_url":"https://github.com/orbbec/pyorbbecsdk","commit_stats":null,"previous_names":["orbbec/pyorbbecsdk"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/orbbec/pyorbbecsdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orbbec%2Fpyorbbecsdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orbbec%2Fpyorbbecsdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orbbec%2Fpyorbbecsdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orbbec%2Fpyorbbecsdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/orbbec","download_url":"https://codeload.github.com/orbbec/pyorbbecsdk/tar.gz/refs/heads/v2-main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orbbec%2Fpyorbbecsdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29411146,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-13T06:24:03.484Z","status":"ssl_error","status_checked_at":"2026-02-13T06:23:12.830Z","response_time":78,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","camera","camera-api","computer-vision","depth-camera","developer-kits","hardware","sdk-python"],"created_at":"2026-01-17T21:22:13.581Z","updated_at":"2026-02-13T15:28:20.551Z","avatar_url":"https://github.com/orbbec.png","language":"C++","readme":"# Python Bindings for Orbbec SDK\n\nthe v2-main branch provides Python bindings for the [Orbbec SDK v2.x](https://github.com/orbbec/OrbbecSDK_v2),  enabling developers to interface with Orbbec devices using Python. The Orbbec SDK v.2.x is an open-source cross-platform SDK library based on Orbbec RGB-D cameras. The differences between Orbbec SDK v2.x and [Orbbec SDK v1.x](https://github.com/orbbec/OrbbecSDK) can be found in the [README](https://github.com/orbbec/OrbbecSDK_v2).\n\nIf you are a user in China, it is recommended to use [gitee Repo](https://gitee.com/orbbecdeveloper/pyorbbecsdk).\n\u003e [!IMPORTANT]\n\u003e\n\u003e 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.\n\nHere is the device support list of main branch (v1.x) and v2-main branch (v2.x):\n\n\u003ctable border=\"1\" style=\"border-collapse: collapse; text-align: left; width: 100%;\"\u003e\n  \u003cthead\u003e\n    \u003ctr style=\"background-color: #1f4e78; color: white; text-align: center;\"\u003e\n      \u003cth\u003eProduct Series\u003c/th\u003e\n      \u003cth\u003eProduct\u003c/th\u003e\n      \u003cth\u003e\u003ca href=\"https://github.com/orbbec/pyorbbecsdk/tree/main\" style=\"color: black; text-decoration: none;\"\u003eBranch main\u003c/a\u003e\u003c/th\u003e\n      \u003cth\u003e\u003ca href=\"https://github.com/orbbec/pyorbbecsdk/tree/v2-main\" style=\"color: black; text-decoration: none;\"\u003eBranch v2-main\u003c/a\u003e\u003c/th\u003e\n    \u003c/tr\u003e\n  \u003c/thead\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd style=\"text-align: center; font-weight: bold;\"\u003eGemini 435Le\u003c/td\u003e\n      \u003ctd\u003eGemini 435Le\u003c/td\u003e\n      \u003ctd\u003enot supported\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd rowspan=\"8\" style=\"text-align: center; font-weight: bold;\"\u003eGemini 330\u003c/td\u003e\n      \u003ctd\u003eGemini 335Le\u003c/td\u003e\n      \u003ctd\u003enot supported\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eGemini 335\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eGemini 336\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eGemini 330\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eGemini 335L\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eGemini 336L\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eGemini 330L\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eGemini 335Lg\u003c/td\u003e\n      \u003ctd\u003enot supported\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd rowspan=\"5\" style=\"text-align: center; font-weight: bold;\"\u003eGemini 2\u003c/td\u003e\n      \u003ctd\u003eGemini 2\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eGemini 2 L\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eGemini 2 XL\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n      \u003ctd\u003eto be supported\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eGemini 215\u003c/td\u003e\n      \u003ctd\u003enot supported\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eGemini 210\u003c/td\u003e\n      \u003ctd\u003enot supported\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd rowspan=\"3\" style=\"text-align: center; font-weight: bold;\"\u003eFemto\u003c/td\u003e\n      \u003ctd\u003eFemto Bolt\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eFemto Mega\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eFemto Mega I\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd rowspan=\"3\" style=\"text-align: center; font-weight: bold;\"\u003eAstra\u003c/td\u003e\n      \u003ctd\u003eAstra 2\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eAstra+\u003c/td\u003e\n      \u003ctd\u003elimited maintenance\u003c/td\u003e\n      \u003ctd\u003enot supported\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003eAstra Pro Plus\u003c/td\u003e\n      \u003ctd\u003elimited maintenance\u003c/td\u003e\n      \u003ctd\u003enot supported\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd style=\"text-align: center; font-weight: bold;\"\u003eAstra Mini\u003c/td\u003e\n      \u003ctd\u003eAstra Mini (S) Pro\u003c/td\u003e\n      \u003ctd\u003efull maintenance\u003c/td\u003e\n      \u003ctd\u003erecommended for new designs\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n**Note**:\n- If you do not find your device, please contact our FAE or sales representative for help.\n- Starting from October 2025 (Orbbec SDK v2.5.5), we will begin upgrading devices that use the OpenNI protocol to the UVC protocol, Already upgraded devices and future upgrade schedule and how to upgrade from openni protocol to uvc protocol,please refer to [the document](https://github.com/orbbec/OrbbecSDK_v2?tab=readme-ov-file#12-upgrading-from-openni-protocol-to-uvc-protocol).\n\n\n**Definition**:\n\n1. recommended for new designs: we will provide full supports with new features,  bug fix and performance optimization;\n2. full maintenance: we will provide bug fix support;\n3. limited maintenance: we will provide critical bug fix support;\n4. not supported: we will not support specific device in this version;\n5. to be supported: we will add support in the near future.\n\n\n## Hardware Products Supported by Python SDK\n\n| **Products List** | **Minimal Firmware Version** | **Recommended Firmware Version**    |\n|-------------------|------------------------------|-------------------------------|\n| Gemini 305        | 1.0.30                       |        1.0.30                       |\n| Gemini 345        | 1.7.04                       |        1.9.03                       |\n| Gemini 345Lg        | 1.7.04                     |        1.9.03                   |\n| Gemini 435Le        | 1.2.4                     |        1.3.6                   |\n| Gemini 335Le        | 1.5.31                     |        1.6.00                     |\n| Gemini 330        | 1.2.20                       |        1.6.00                       |\n| Gemini 330L       | 1.2.20                       |       1.6.00                      |\n| Gemini 335        | 1.2.20                       |       1.6.00                        |\n| Gemini 335L       | 1.2.20                       |        1.6.00                       |\n| Gemini 336        | 1.2.20                       |       1.6.00                        |\n| Gemini 336L       | 1.2.20                       |        1.6.00                       |\n| Gemini 335Lg      | 1.3.46                       |        1.6.00                       |\n| Femto Bolt        | 1.1.2                  |              1.1.3                       |\n| Femto Mega        | 1.3.0                  |              1.3.1                       |\n| Femto Mega I        | 2.0.4                  |            2.0.4                     |\n| Astra 2           | 2.8.20                       |         2.8.20                      |\n| Gemini 2 L        | 1.4.53                       |        1.5.2                       |\n| Gemini 2          | 1.4.92               |                1.4.98                       |\n| Gemini 215        | 1.0.9                        |        1.0.9                      |\n| Gemini 210        | 1.0.9                        |        1.0.9                      |\n| Astra mini Pro        | 2.0.03                        |        2.0.03                        |\n| Astra mini S Pro        | 2.0.03                        |        2.0.03                        |\n| Pulsar SL450        | 2.2.4.5                        |        2.2.4.5                        |\n| Pulsar ME450        | 1.0.0.6                        |        1.0.0.6                        |\n\n## Supported Platforms\n\n- Windows: Windows 10 (x64)\n- Linux: 18.04/20.04/22.04 (x64)\n- Arm64: Ubuntu18.04/20.04/22.04\n\n## Supported Python Versions\n\npython 3.8 to python 3.13\n\n## Environment Setup\n\n### Windows\n\nFor windows, you need to register the metadata associated with frames (this includes things like timestamps and other information about the video frame).\n\n- Connect the device and confirm that the device is online;\n- Open PowerShell with administrator privileges, then use the `cd` command to enter the directory where the `obsensor_metadata_win10.ps1` script is located;\n- Execute the `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser` command, and enter `Y` as prompted to confirm;\n\n  Try to execute the `Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser` command if the previous command fails in some cases;\n- Execute `.\\obsensor_metadata_win10.ps1 -op install_all` to complete the registration.\n\n\n*Notes: If the metadata is not registered, the device timestamp will be abnormal, thereby affecting the SDK's internal frame synchronization functionality.*\n\n\n### Linux\n\nFor Linux, we have provided a script to help you set up the environment. You can run the script as follows:\n\n```bash\n  cd pyorbbecsdk/scripts/env_setup\n  sudo chmod +x ./install_udev_rules.sh\n  sudo ./install_udev_rules.sh\n  sudo udevadm control --reload \u0026\u0026 sudo udevadm trigger\n```\n\n*Notes: If this script is not executed, open the device will fail due to permission issues.*\n\n## How to Use install package\nTo make Python more user-friendly, We provide two installation methods: online installation and offline installation.\n\n\n### Windows\n\nWe provide both online and offline installation packages for Python versions **3.8** to **3.13**.\n\nFollow the [windows install documentation](\nhttps://orbbec.github.io/pyorbbecsdk/source/2_installation/install_the_package.html#windows) to install the SDK online or offline. Then verify the package and run the sample.\n\n\n### Linux\n\nWe provide online installation packages for Python versions **3.9** to **3.13** and provide offline installation packages for Python versions **3.8** to **3.13**.\n\nFollow the [linux install documentation](\nhttps://orbbec.github.io/pyorbbecsdk/source/2_installation/install_the_package.html#linux) to install the SDK online or offline. Then verify the package and run the sample.\n\n## Documentation\n\n[Orbbec SDK V2 Python Wrapper User Guide](https://orbbec.github.io/pyorbbecsdk/index.html) provides an overview of the concepts and architecture of Orbbec SDK v2, details on the Python Wrapper installation packages and source compilation, an introduction to commonly used Python Wrapper interfaces, and a FAQ section. Please read it carefully.\n\n\n## License\nThis project is licensed under the Apache License 2.0.\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forbbec%2Fpyorbbecsdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Forbbec%2Fpyorbbecsdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forbbec%2Fpyorbbecsdk/lists"}