Skip to content

Commit c14b6ea

Browse files
committed
Add hardware video codec support info to README.md.
1 parent 477cc52 commit c14b6ea

1 file changed

Lines changed: 15 additions & 0 deletions

File tree

README.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -274,6 +274,21 @@ LiveKit is a dynamic realtime environment and calls can fail for various reasons
274274

275275
You may throw errors of the type `RpcError` with a string `message` in an RPC method handler and they will be received on the caller's side with the message intact. Other errors will not be transmitted and will instead arrive to the caller as `1500` ("Application Error"). Other built-in errors are detailed in `RpcError`.
276276

277+
## Hardware video codec support
278+
279+
The underlying Rust SDK ships with platform-specific hardware-accelerated encoders/decoders, which are enabled automatically when the requested codec and OS match.
280+
281+
| Platform | Codec(s) | Encoder | Decoder | Backend |
282+
| ------------------------------ | ---------- | ------- | ------- | -------------------------------------- |
283+
| macOS | H264, H265 ||| VideoToolbox |
284+
| Linux (AMD GPU) | H264 || | VAAPI |
285+
| Linux x64 (NVIDIA GPU) | H264, H265 ||| NVENC / NVDEC (NVIDIA Video Codec SDK) |
286+
| Linux ARM (NVIDIA Jetson) | H264, H265 | ? | ? | NVENC / NVDEC (to be confirmed) |
287+
288+
Software encoders (libvpx for VP8/VP9, libaom for AV1, OpenH264 for H264) are used as a fallback on platforms or codecs not listed above.
289+
290+
> **Note:** NVIDIA data-center / AI-inference GPUs such as the **H100, H200, A100** physically omit the NVENC/NVDEC engines — running on these cards will silently fall back to the software encoder/decoder regardless of the table above.
291+
277292
## Examples
278293

279294
- [Facelandmark](https://github.com/livekit/python-sdks/tree/main/examples/face_landmark): Use mediapipe to detect face landmarks (eyes, nose ...)

0 commit comments

Comments
 (0)