# libcamera-org/libcamera architecture

> Architecture diagram of the GitHub repository libcamera-org/libcamera, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/libcamera-org/libcamera
- Repository: https://github.com/libcamera-org/libcamera

## Overview

libcamera is a Linux, Android, and ChromeOS camera support library. The principal flow is camera discovery, device-specific pipeline matching and configuration, then request-based frame capture; IPA modules provide image-processing control. Users can access the stack through the core API and documented Android, GStreamer, cam, and qcam interfaces. The graph emphasizes the core runtime and major documented interfaces. Evidence is limited to the README and the sampled excerpts or SOURCE INDEX references; unsampled implementation details are not asserted.

Main entry points: [`src/libcamera/pipeline_handler.cpp`](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/pipeline_handler.cpp) (Pipeline handler), [`src/libcamera/camera_manager.cpp`](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/camera_manager.cpp) (Camera manager), [`src/libcamera/camera.cpp`](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/camera.cpp) (Camera API), [`src/libcamera/media_pipeline.cpp`](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/media_pipeline.cpp) (Media pipeline)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Camera Core"]
  node_manager["Camera manager<br/>[camera_manager.cpp]"]
  node_handler["Pipeline handler"]
  node_camera["Camera API<br/>[camera.cpp]"]
  node_request["Capture request<br/>[request.cpp]"]
  node_framebuffer["Frame buffers<br/>[framebuffer.cpp]"]
end

subgraph group_media["Media Devices"]
  node_enumerator["Device enumerator"]
  node_media_pipeline["Media pipeline<br/>[media_pipeline.cpp]"]
  node_sensor["Camera sensor<br/>[camera_sensor.cpp]"]
  node_v4l2["V4L2 devices<br/>[v4l2_device.cpp]"]
  node_rpi_pipeline["Raspberry Pi pipeline<br/>[pipeline_base.cpp]"]
end

subgraph group_ipa["Image Processing"]
  node_ipa_manager["IPA manager<br/>[ipa_manager.cpp]"]
  node_ipa_proxy["IPA proxy<br/>[ipa_proxy.cpp]"]
  node_rpi_controller["RPi ISP algorithms<br/>[controller.cpp]"]
end

subgraph group_clients["Client Interfaces"]
  node_android["Android HAL"]
  node_gstreamer["GStreamer plugin"]
  node_python["Python bindings"]
end

subgraph group_apps["Capture Applications"]
  node_cam["cam capture tool<br/>[main.cpp]"]
  node_qcam["qcam viewer<br/>[main.cpp]"]
end

node_user(("Application user"))
node_kernel["Linux media devices"]

node_user -->|"runs capture"| node_cam
node_user -->|"builds pipelines"| node_gstreamer
node_user -->|"uses camera HAL"| node_android
node_user -.->|"views camera"| node_qcam
node_manager -->|"starts discovery"| node_enumerator
node_manager -->|"matches factories"| node_handler
node_manager -->|"initializes manager"| node_ipa_manager
node_enumerator -.->|"enumerates devices"| node_kernel
node_handler -.->|"configures topology"| node_media_pipeline
node_media_pipeline -->|"configures sensor"| node_sensor
node_media_pipeline -->|"routes subdevices"| node_v4l2
node_handler -->|"registers cameras"| node_camera
node_camera -.->|"queues capture"| node_request
node_handler -->|"queues prepared requests"| node_request
node_handler -.->|"completes buffers"| node_framebuffer
node_handler -->|"creates IPA"| node_ipa_manager
node_ipa_manager -->|"creates proxy"| node_ipa_proxy
node_rpi_pipeline -->|"configures IPA"| node_ipa_proxy
node_android -->|"opens camera"| node_camera
node_cam -->|"starts manager"| node_manager
node_cam -->|"creates sessions"| node_camera
node_gstreamer -->|"captures frames"| node_camera
node_python -->|"binds manager"| node_manager

click node_manager "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/camera_manager.cpp"
click node_enumerator "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/device_enumerator.cpp"
click node_handler "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/pipeline_handler.cpp"
click node_media_pipeline "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/media_pipeline.cpp"
click node_sensor "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/sensor/camera_sensor.cpp"
click node_v4l2 "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/v4l2_device.cpp"
click node_camera "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/camera.cpp"
click node_request "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/request.cpp"
click node_framebuffer "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/framebuffer.cpp"
click node_ipa_manager "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/ipa_manager.cpp"
click node_ipa_proxy "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/ipa_proxy.cpp"
click node_rpi_pipeline "https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/pipeline/rpi/common/pipeline_base.cpp"
click node_rpi_controller "https://github.com/libcamera-org/libcamera/blob/master/src/ipa/rpi/controller/controller.cpp"
click node_android "https://github.com/libcamera-org/libcamera/blob/master/src/android/camera_hal_manager.cpp"
click node_gstreamer "https://github.com/libcamera-org/libcamera/blob/master/src/gstreamer/gstlibcamerasrc.cpp"
click node_python "https://github.com/libcamera-org/libcamera/blob/master/src/py/libcamera/py_camera_manager.cpp"
click node_cam "https://github.com/libcamera-org/libcamera/blob/master/src/apps/cam/main.cpp"
click node_qcam "https://github.com/libcamera-org/libcamera/blob/master/src/apps/qcam/main.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_manager,node_handler,node_camera,node_request,node_framebuffer,node_user toneBlue
class node_enumerator,node_media_pipeline,node_sensor,node_v4l2,node_rpi_pipeline toneAmber
class node_ipa_manager,node_ipa_proxy,node_rpi_controller toneMint
class node_android,node_gstreamer,node_python toneRose
class node_cam,node_qcam,node_kernel toneIndigo
```

## Components

### Camera Core

- [Camera manager](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/camera_manager.cpp): `src/libcamera/camera_manager.cpp`
- [Pipeline handler](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/pipeline_handler.cpp): `src/libcamera/pipeline_handler.cpp`
- [Camera API](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/camera.cpp): `src/libcamera/camera.cpp`
- [Capture request](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/request.cpp): `src/libcamera/request.cpp`
- [Frame buffers](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/framebuffer.cpp): `src/libcamera/framebuffer.cpp`

### Media Devices

- [Device enumerator](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/device_enumerator.cpp): `src/libcamera/device_enumerator.cpp`
- [Media pipeline](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/media_pipeline.cpp): `src/libcamera/media_pipeline.cpp`
- [Camera sensor](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/sensor/camera_sensor.cpp): `src/libcamera/sensor/camera_sensor.cpp`
- [V4L2 devices](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/v4l2_device.cpp): `src/libcamera/v4l2_device.cpp`
- [Raspberry Pi pipeline](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/pipeline/rpi/common/pipeline_base.cpp): `src/libcamera/pipeline/rpi/common/pipeline_base.cpp`

### Image Processing

- [IPA manager](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/ipa_manager.cpp): `src/libcamera/ipa_manager.cpp`
- [IPA proxy](https://github.com/libcamera-org/libcamera/blob/master/src/libcamera/ipa_proxy.cpp): `src/libcamera/ipa_proxy.cpp`
- [RPi ISP algorithms](https://github.com/libcamera-org/libcamera/blob/master/src/ipa/rpi/controller/controller.cpp): `src/ipa/rpi/controller/controller.cpp`

### Client Interfaces

- [Android HAL](https://github.com/libcamera-org/libcamera/blob/master/src/android/camera_hal_manager.cpp): `src/android/camera_hal_manager.cpp`
- [GStreamer plugin](https://github.com/libcamera-org/libcamera/blob/master/src/gstreamer/gstlibcamerasrc.cpp): `src/gstreamer/gstlibcamerasrc.cpp`
- [Python bindings](https://github.com/libcamera-org/libcamera/blob/master/src/py/libcamera/py_camera_manager.cpp): `src/py/libcamera/py_camera_manager.cpp`

### Capture Applications

- [cam capture tool](https://github.com/libcamera-org/libcamera/blob/master/src/apps/cam/main.cpp): `src/apps/cam/main.cpp`
- [qcam viewer](https://github.com/libcamera-org/libcamera/blob/master/src/apps/qcam/main.cpp): `src/apps/qcam/main.cpp`

### Other components

- **Application user**
- **Linux media devices**

## Connections

- Application user → cam capture tool: runs capture (evidence: `README.rst`)
- Application user → GStreamer plugin: builds pipelines (evidence: `README.rst`)
- Application user → Android HAL: uses camera HAL (evidence: `README.rst`)
- Application user → qcam viewer: views camera
- Camera manager → Device enumerator: starts discovery (evidence: `src/libcamera/camera_manager.cpp`)
- Camera manager → Pipeline handler: matches factories (evidence: `src/libcamera/camera_manager.cpp`)
- Camera manager → IPA manager: initializes manager (evidence: `src/libcamera/camera_manager.cpp`)
- Device enumerator → Linux media devices: enumerates devices
- Pipeline handler → Media pipeline: configures topology
- Media pipeline → Camera sensor: configures sensor (evidence: `src/libcamera/media_pipeline.cpp`)
- Media pipeline → V4L2 devices: routes subdevices (evidence: `src/libcamera/media_pipeline.cpp`)
- Pipeline handler → Camera API: registers cameras (evidence: `src/libcamera/pipeline_handler.cpp`)
- Camera API → Capture request: queues capture
- Pipeline handler → Capture request: queues prepared requests (evidence: `src/libcamera/pipeline_handler.cpp`)
- Pipeline handler → Frame buffers: completes buffers
- Pipeline handler → IPA manager: creates IPA
- IPA manager → IPA proxy: creates proxy
- Raspberry Pi pipeline → IPA proxy: configures IPA (evidence: `src/libcamera/pipeline/rpi/common/pipeline_base.cpp`)
- Android HAL → Camera API: opens camera (evidence: `src/android/camera_hal_manager.cpp`)
- cam capture tool → Camera manager: starts manager (evidence: `src/apps/cam/main.cpp`)
- cam capture tool → Camera API: creates sessions (evidence: `src/apps/cam/main.cpp`)
- GStreamer plugin → Camera API: captures frames (evidence: `README.rst`)
- Python bindings → Camera manager: binds manager (evidence: `src/py/libcamera/py_camera_manager.cpp`)
