Overview#

The PyNvVideoCodec API provides Python bindings for NVIDIA’s hardware-accelerated video encoding and decoding capabilities. This reference documents all public APIs organized by functional area.

API Summary#

The following table lists all PyNvVideoCodec APIs organized by category.

Category

API

Description

Decoder

SimpleDecoder

Straightforward decoder that reads video files and outputs decoded frames. Recommended for most users.

ThreadedDecoder

Performance-optimized decoder with background thread prefetching, ideal for AI/ML pipelines.

CoreDecoder

Demuxer

Container parser that separates compressed video packets from container formats.

Decoder

Core decoder class for elementary video bitstreams. Provides maximum control.

Encoder

Encoder

Video encoder class for encoding raw frames to compressed packets.

Transcoder

Transcoder

Combines decoding, encoding, and muxing for video format conversion. Supports full and segmented transcoding.

Module Information#

Module-level attributes and version information.

Attribute

Description

version

PyNvVideoCodec version string

cuda_version

CUDA Toolkit version used to build the module

video_codec_sdk_version

NVIDIA Video Codec SDK version

Access version information via nvc.__version__, nvc.__cuda_version__, and nvc.__video_codec_sdk_version__.