{"id":13436863,"url":"https://github.com/IntelRealSense/librealsense","last_synced_at":"2025-03-18T21:31:15.409Z","repository":{"id":37252565,"uuid":"46374199","full_name":"IntelRealSense/librealsense","owner":"IntelRealSense","description":"Intel® RealSense™ SDK","archived":false,"fork":false,"pushed_at":"2023-12-21T12:06:24.000Z","size":270126,"stargazers_count":7132,"open_issues_count":420,"forks_count":4768,"subscribers_count":293,"default_branch":"master","last_synced_at":"2023-12-21T18:50:04.395Z","etag":null,"topics":["camera-api","computer-vision","developer-kits","hardware","library","librealsense","sdk"],"latest_commit_sha":null,"homepage":"https://www.intelrealsense.com/","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/IntelRealSense.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2015-11-17T20:42:18.000Z","updated_at":"2023-12-24T09:32:04.903Z","dependencies_parsed_at":"2023-12-21T12:18:58.061Z","dependency_job_id":null,"html_url":"https://github.com/IntelRealSense/librealsense","commit_stats":{"total_commits":11175,"total_committers":379,"mean_commits":"29.485488126649077","dds":0.8961073825503356,"last_synced_commit":"ea975f8641a83a38a3f2ef3baa4cc42e94a75219"},"previous_names":[],"tags_count":150,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IntelRealSense%2Flibrealsense","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IntelRealSense%2Flibrealsense/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IntelRealSense%2Flibrealsense/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IntelRealSense%2Flibrealsense/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IntelRealSense","download_url":"https://codeload.github.com/IntelRealSense/librealsense/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244094240,"owners_count":20397020,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["camera-api","computer-vision","developer-kits","hardware","library","librealsense","sdk"],"created_at":"2024-07-31T03:00:52.642Z","updated_at":"2025-03-18T21:31:15.404Z","avatar_url":"https://github.com/IntelRealSense.png","language":"C++","funding_links":[],"categories":["C++","Topics","Tools/SDKs for AR/VR"],"sub_categories":["Sensors / Hardware"],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"doc/img/realsense.png\" width=\"70%\" /\u003e\u003cbr\u003e\u003cbr\u003e\u003c/p\u003e\n\n-----------------\n[![License](https://img.shields.io/github/license/IntelRealSense/librealsense.svg)](https://www.apache.org/licenses/LICENSE-2.0)\n[![Release](https://img.shields.io/github/v/release/IntelRealSense/librealsense?sort=semver)](https://github.com/IntelRealSense/librealsense/releases/latest)\n[![Commits](https://img.shields.io/github/commits-since/IntelRealSense/librealsense/master/development?label=commits%20since)](https://github.com/IntelRealSense/librealsense/compare/master...development)\n[![Issues](https://img.shields.io/github/issues/IntelRealSense/librealsense.svg)](https://github.com/IntelRealSense/librealsense/issues)\n[![GitHub CI](../../actions/workflows/buildsCI.yaml/badge.svg?branch=development)](../../actions/workflows/buildsCI.yaml)\n[![Forks](https://img.shields.io/github/forks/IntelRealSense/librealsense.svg)](https://github.com/IntelRealSense/librealsense/network/members)\n\n\n\n## Overview\n**Intel® RealSense™ SDK 2.0** is a cross-platform library for Intel® RealSense™ depth cameras.\n\n\u003e :pushpin: For other Intel® RealSense™ devices (F200, R200, LR200 and ZR300), please refer to the [latest legacy release](https://github.com/IntelRealSense/librealsense/tree/v1.12.1).\n\nThe SDK allows depth and color streaming, and provides intrinsic and extrinsic calibration information.\nThe library also offers synthetic streams (pointcloud, depth aligned to color and vise-versa), and a built-in support for [record and playback](./doc/record-and-playback.md) of streaming sessions.\n\nDeveloper kits containing the necessary hardware to use this library are available for purchase at [store.intelrealsense.com](https://store.intelrealsense.com/products.html).\nInformation about the Intel® RealSense™ technology at [www.intelrealsense.com](https://www.intelrealsense.com/)\n\n\u003e :open_file_folder: Don't have access to a RealSense camera? Check-out [sample data](./doc/sample-data.md)\n\n## Update on Recent Changes to the RealSense Product Line\n\nIntel has EOLed the LiDAR, Facial Authentication, and Tracking product lines. These products have been discontinued and will no longer be available for new orders.\n\nIntel WILL continue to sell and support stereo products including the following: D410, D415, D430, , D401 ,D450 modules and D415, D435, D435i, D435f, D405, D455, D457 depth cameras. We will also continue the work to support and develop our LibRealSense open source SDK.\n\nIn the future, Intel and the RealSense team will focus our new development on advancing innovative technologies that better support our core businesses and IDM 2.0 strategy.\n\n## Building librealsense - Using vcpkg\n\nYou can download and install librealsense using the [vcpkg](https://github.com/Microsoft/vcpkg) dependency manager:\n\n    git clone https://github.com/Microsoft/vcpkg.git\n    cd vcpkg\n    ./bootstrap-vcpkg.sh\n    ./vcpkg integrate install\n    ./vcpkg install realsense2\n\nThe librealsense port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.\n\n## Download and Install\n* **Download** - The latest releases including the Intel RealSense SDK, Viewer and Depth Quality tools are available at: [**latest releases**](https://github.com/IntelRealSense/librealsense/releases). Please check the [**release notes**](https://github.com/IntelRealSense/librealsense/wiki/Release-Notes) for the supported platforms, new features and capabilities, known issues, how to upgrade the Firmware and more.\n\n* **Install** - You can also install or build from source the SDK (on [Linux](./doc/distribution_linux.md) \\ [Windows](./doc/distribution_windows.md) \\ [Mac OS](doc/installation_osx.md) \\ [Android](./doc/android.md) \\ [Docker](./scripts/Docker/readme.md)), connect your D400 depth camera and you are ready to start writing your first application.\n\n\u003e **Support \u0026 Issues**: If you need product support (e.g. ask a question about / are having problems with the device), please check the [FAQ \u0026 Troubleshooting](https://github.com/IntelRealSense/librealsense/wiki/Troubleshooting-Q%26A) section.\n\u003e If not covered there, please search our [Closed GitHub Issues](https://github.com/IntelRealSense/librealsense/issues?utf8=%E2%9C%93\u0026q=is%3Aclosed) page,  [Community](https://communities.intel.com/community/tech/realsense) and [Support](https://www.intel.com/content/www/us/en/support/emerging-technologies/intel-realsense-technology.html) sites.\n\u003e If you still cannot find an answer to your question, please [open a new issue](https://github.com/IntelRealSense/librealsense/issues/new).\n\n## What’s included in the SDK:\n| What | Description | Download link|\n| ------- | ------- | ------- |\n| **[Intel® RealSense™ Viewer](./tools/realsense-viewer)** | With this application, you can quickly access your Intel® RealSense™ Depth Camera to view the depth stream, visualize point clouds, record and playback streams, configure your camera settings, modify advanced controls, enable depth visualization and post processing  and much more. | [**Intel.RealSense.Viewer.exe**](https://github.com/IntelRealSense/librealsense/releases) |\n| **[Depth Quality Tool](./tools/depth-quality)** | This application allows you to test the camera’s depth quality, including: standard deviation from plane fit, normalized RMS – the subpixel accuracy, distance accuracy and fill rate. You should be able to easily get and interpret several of the depth quality metrics and record and save the data for offline analysis. |[**Depth.Quality.Tool.exe**](https://github.com/IntelRealSense/librealsense/releases) |\n| **[Debug Tools](./tools/)** | Device enumeration, FW logger, etc as can be seen at the tools directory | Included in [**Intel.RealSense.SDK.exe**](https://github.com/IntelRealSense/librealsense/releases)|\n| **[Code Samples](./examples)** |These simple examples demonstrate how to easily use the SDK to include code snippets that access the camera into your applications. Check some of the [**C++ examples**](./examples) including capture, pointcloud and more and basic [**C examples**](./examples/C) | Included in [**Intel.RealSense.SDK.exe**](https://github.com/IntelRealSense/librealsense/releases) |\n| **[Wrappers](https://github.com/IntelRealSense/librealsense/tree/development/wrappers)** | [Python](./wrappers/python), [C#/.NET](./wrappers/csharp) API, as well as integration with the following 3rd-party technologies: [ROS1](https://github.com/IntelRealSense/realsense-ros/tree/ros1-legacy), [ROS2](https://github.com/IntelRealSense/realsense-ros/tree/ros2-development), [LabVIEW](./wrappers/labview), [OpenCV](./wrappers/opencv), [PCL](./wrappers/pcl), [Unity](./wrappers/unity), [Matlab](./wrappers/matlab), [OpenNI](./wrappers/openni2), [UnrealEngine4](./wrappers/unrealengine4) and more to come. | |\n\n\n## Ready to Hack!\n\nOur library offers a high level API for using Intel RealSense depth cameras (in addition to lower level ones).\nThe following snippet shows how to start streaming frames and extracting the depth value of a pixel:\n\n```cpp\n// Create a Pipeline - this serves as a top-level API for streaming and processing frames\nrs2::pipeline p;\n\n// Configure and start the pipeline\np.start();\n\nwhile (true)\n{\n    // Block program until frames arrive\n    rs2::frameset frames = p.wait_for_frames();\n\n    // Try to get a frame of a depth image\n    rs2::depth_frame depth = frames.get_depth_frame();\n\n    // Get the depth frame's dimensions\n    float width = depth.get_width();\n    float height = depth.get_height();\n\n    // Query the distance from the camera to the object in the center of the image\n    float dist_to_center = depth.get_distance(width / 2, height / 2);\n\n    // Print the distance\n    std::cout \u003c\u003c \"The camera is facing an object \" \u003c\u003c dist_to_center \u003c\u003c \" meters away \\r\";\n}\n```\nFor more information on the library, please follow our [examples](./examples), and read the [documentation](./doc) to learn more.\n\n## Contributing\nIn order to contribute to Intel RealSense SDK, please follow our [contribution guidelines](CONTRIBUTING.md).\n\n## License\nThis project is licensed under the [Apache License, Version 2.0](LICENSE).\nCopyright 2018 Intel Corporation\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FIntelRealSense%2Flibrealsense","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FIntelRealSense%2Flibrealsense","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FIntelRealSense%2Flibrealsense/lists"}