Get Started with PyNvVideoCodec

System Requirements

PyNvVideoCodec Latest Version

• Pip install from PyPl (recommended)
  
  

  Ready to use Python WHLs of PyNvVideoCodec library for popular configurations, including Python samples are available on PyPl and can be installed by running the following command on shell prompt

• Download source on NGC and build 

  
  
  Package containing PyNvVideoCodec source code, its dependencies, Python sample applications and documents is available on NVIDIA NGC. To install PyNvVideoCodec library please download zip file containing the latest version of PyNvVideoCodec from the NVIDIA NGC catalog page (located in the file browser tab) onto your local machine. Then, open the shell prompt, go to the folder containing the zip file and execute the following command, replacing "PyNvVideoCodec.zip'' with the actual name of the downloaded zip file.
  
  pip install PyNvVideoCodec.zip
  
  

  Please use this method of installation in case you need any customizations in PyNvVideoCodec library. e.g. enabling NVTX markers for profiling, support for specific surface format etc.

Release Notes

This release of PyNvVideoCodec includes support for the following features:

Decode Features

• Seek and frame sampling: Provides efficient and flexible methods for fetching video frames in various modes, including sequential, random, periodic, indexed, batched, and sliced, as well as at a specified target frame rate.

• Decoder caching: Optimizes decoding of short video clips through decoder caching and reconfiguration.

• Threaded decoder: Supports decoding on a separate thread, delivering pre-decoded frames with near-zero latency, enabling high-performance video processing pipelines.

• Video processing from buffer: Supports video processing from memory buffers, reducing I/O overhead, enabling streaming applications.

• Low latency decode: Offers zero-latency decoding for video sequences that do not contain B-frames.

• SEI extraction: Supports the extraction of Supplemental Enhancement Information (SEI) messages, allowing access to additional information such as HDR information, timecodes, and custom user data.

• Stream metadata access: Enables access to stream metadata, including frame width, height, bit depth, and keyframe indices, to enhance content management.

• GIL handling: Improved multithreaded performance through better handling of Global Interpreter Lock (GIL) in C++ layer.

• Multi-GPU decode: Enables multi-GPU decoding to efficiently handle larger workloads.

• Extended codec support: Supports codecs H.264, HEVC, AV1, VP8, VP9, VC1, MPEG4, MPEG2, and MPEG1

• 4:2:2 decode: Supports 4:2:2 decoding for both H.264 and HEVC formats on Blackwell GPUs (NV16, P210 and P216 surface formats).

• Extended output formats : Decode to various output formats including NV12, YUV420, YUV444, NV16, P010, P016 and RGB24(interleaved and planar)

Encode Features

• Encoder reconfiguration: Supports encoder reconfiguration, enabling dynamic updating of encoding parameters without recreating encoder instances.

• SEI insertion: Allows insertion of SEI messages during encoding.

• GIL handling: Improved multithreaded performance through better handling of Global Interpreter Lock (GIL) in C++ layer.

• Multi-GPU encode: Enables multi-GPU encoding to efficiently handle larger workloads.

• Codec support: Support encoding to codec H.264, HEVC, and AV1.

• 4:2:2 encode: Supports 4:2:2 encoding for both H.264 and HEVC formats on Blackwell GPUs (NV16 and P210 surface formats).

• Extended input formats: Encode from various input formats including NV12, YV12, IYUV, YUV444, YUV420_10BIT, YUV444_10BIT, NV16, P210, ARGB, ABGR, ARGB10, and ABGR10.

Transcode Features

• Segment-based transcode: Enables transcoding of video segments based on timestamp ranges, ideal for content editing and partial processing.