# librealsense **Repository Path**: sazass/librealsense ## Basic Information - **Project Name**: librealsense - **Description**: RealSense SDK - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-12-24 - **Last Updated**: 2025-12-24 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

RealSense SDK 2.0 is a cross-platform library for RealSense depth cameras. The SDK allows depth and color streaming, and provides intrinsic and extrinsic calibration information.

## Important Notice We are happy to announce that the RealSense GitHub repositories have been successfully migrated to the RealSenseAI organization. Please make sure to update your links to the new RealSenseAI organization for both cloning the repositories and accessing specific files within them. [https://github.com/**IntelRealSense**/librealsense](https://github.com/IntelRealSense/librealsense) --> [https://github.com/**realsenseai**/librealsense](https://github.com/realsenseai/librealsense) Note: A redirection from the previous name IntelRealSense is currently in place, but we cannot guarantee how long it will remain active. We recommend that all users update their references to point to the new GitHub location. ## Use Cases Below are some of the many real-world applications powered by RealSense technology: Robotics | Depth Sensing | 3D Scanning | :------------: | :----------: | :-------------: |

Drones | Skeletal and People Tracking | Facial Authentication | :--------------------------: | :-----: | :----------------------: |

## Why RealSense? - **High-resolution color and depth** at close and long ranges - **Open source SDK** with rich examples and wrappers (Python, ROS, C#, Unity and [more...](https://github.com/realsenseai/librealsense/tree/master/wrappers)) - **Active developer community and defacto-standard 3D stereo camera for robotics** - **Cross-platform** support: Windows, Linux, macOS, Android, and Docker ## Product Line RealSense stereo depth products use stereo vision to calculate depth, providing high-quality performance in various lighting and environmental conditions. Here are some examples of the supported models: | Product | Image | Description | |---------|-------|-------------| | [**D555 PoE**](https://realsenseai.com/ruggedized-industrial-stereo-depth/d555-poe/) |

| The RealSense™ Depth Camera D555 introduces Power over Ethernet (PoE) interface on chip, expanding our portfolio of USB and GMSL/FAKRA products. | | [**D457 GMSL/FAKRA**](https://realsenseai.com/ruggedized-industrial-stereo-depth/d457-gmsl-fakra/) |

| The RealSense™ Depth Camera D457 is our first GMSL/FAKRA high bandwidth stereo camera. The D457 has an IP65 grade enclosure protecting it from dust ingress and projected water. | | [**D455**](https://realsenseai.com/stereo-depth-cameras/real-sense-depth-camera-d455/) |

| The RealSense D455 is a long-range stereo depth camera with a 95 mm baseline, global-shutter depth sensors, an RGB sensor, and a built-in IMU, delivering accurate depth at distances up to 10 m.. | | [**D435if**](https://realsenseai.com/stereo-depth-cameras/depth-camera-d435i/) |

| The D435if is one of [RealSense™ Depth Camera with IR pass filter family](https://realsenseai.com/stereo-depth-with-ir-pass-filter/) expanding our portfolio targeting the growing robotic market. The D400f family utilizes an IR pass filter to enhance depth quality and performance range in many robotic environments.| | [**D405**](https://realsenseai.com/stereo-depth-cameras/stereo-depth-camera-d405/) |

| The RealSense™ Depth Camera D405 is a short-range stereo camera providing sub-millimeter accuracy for your close-range computer vision needs. | > 🛍️ [Explore more stereo products](https://store.realsenseai.com/) ## Getting Started Start developing with RealSense in minutes using either method below. ### 1️. Precompiled SDK This is the best option if you want to plug in your camera and get started right away. 1. Download the latest SDK bundle from the [Releases page](https://github.com/realsenseai/librealsense/releases). 2. Connect your RealSense camera. 3. Run the included tools: - [RealSense Viewer](./tools/realsense-viewer/): View streams, tune settings, record and playback. - [Depth Quality Tool](./tools/depth-quality/): Measure accuracy and fill rate. ### Setup Guides - precompiled SDK $Linux\Jetson Guide$

> **Note:** For **minor releases**, we publish Debian packages as release artifacts that you can download and install directly. ### 2️. Build from Source For a more custom installation, follow these steps to build the SDK from source. 1. Clone the repository and create a build directory: ```bash git clone https://github.com/realsenseai/librealsense.git cd librealsense mkdir build && cd build ``` 2. Run CMake to configure the build: ```bash cmake .. ``` 3. Build the project: ```bash cmake --build . ``` ### Setup Guides - build from source

## Python Packages [![pyrealsense2](https://img.shields.io/pypi/v/pyrealsense2.svg?label=pyrealsense2&logo=pypi)](https://pypi.org/project/pyrealsense2/) [![PyPI - pyrealsense2-beta](https://img.shields.io/pypi/v/pyrealsense2-beta.svg?label=pyrealsense2-beta&logo=pypi)](https://pypi.org/project/pyrealsense2-beta/) **Which should I use?** - **Stable:** `pyrealsense2` — validated releases aligned with SDK tags (Recommended for most users). - **Beta:** `pyrealsense2-beta` — fresher builds for early access and testing. Expect faster updates. ### Install ```bash pip install pyrealsense2 # Stable pip install pyrealsense2-beta # Beta ``` > Both packages import as `pyrealsense2`. Install **only one** at a time. ## Ready to Hack! Our library offers a high level API for using RealSense depth cameras (in addition to lower level ones). The following snippets show how to start streaming frames and extracting the depth value of a pixel: **C++** ```cpp #include #include int main() { rs2::pipeline p; // Top-level API for streaming & processing frames p.start(); // Configure and start the pipeline while (true) { rs2::frameset frames = p.wait_for_frames(); // Block until frames arrive rs2::depth_frame depth = frames.get_depth_frame(); // Get depth frame if (!depth) continue; int w = depth.get_width(), h = depth.get_height(); float dist = depth.get_distance(w/2, h/2); // Distance to center pixel std::cout << "The camera is facing an object " << dist << " meters away\r"; } } ``` **Python** ```python import pyrealsense2 as rs pipeline = rs.pipeline() # Create a pipeline pipeline.start() # Start streaming try: while True: frames = pipeline.wait_for_frames() depth_frame = frames.get_depth_frame() if not depth_frame: continue width, height = depth_frame.get_width(), depth_frame.get_height() dist = depth_frame.get_distance(width // 2, height // 2) print(f"The camera is facing an object {dist:.3f} meters away", end="\r") finally: pipeline.stop() # Stop streaming ``` For more information on the library, please follow our [examples](./examples) or [tools](./tools/), and read the [documentation](./doc) to learn more. ## Supported Platforms ### Operating Systems and Platforms | Ubuntu | Windows | macOS High Sierra | Jetson | Raspberry Pi | |--------|---------|-------|--------|----------------| |

### Programming Languages and Wrappers | C++ | C | C# | Python | ROS 2 |Rest API | |-----|---|----|--------|-------|---------| |

| For more platforms and wrappers look over [here](https://dev.realsenseai.com/docs/docs-get-started). > Full feature support varies by platform – refer to the [release notes](https://github.com/realsenseai/librealsense/wiki/Release-Notes) for details. ## Community & Support - [📚 Wiki & Docs](https://github.com/realsenseai/librealsense/wiki) - [🐞 Report Issues](https://github.com/realsenseai/librealsense/issues)- Found a bug or want to contribute? Read our [contribution guidelines](./CONTRIBUTING.md). > 🔎 Looking for legacy devices (F200, R200, LR200, ZR300)? Visit the [legacy release](https://github.com/realsenseai/librealsense/tree/v1.12.1). ---

You can find us at