OpenCvSharp5.official.runtime.linux-x64.headless

OpenCvSharp Native Runtime Package

This is an internal implementation package for OpenCvSharp. It provides the native OpenCV shared library (OpenCvSharpExtern) for a specific platform.

The managed OpenCvSharp API is intentionally designed to stay as close as practical to the native OpenCV C++ API. See OpenCV C++, Python (cv2), and OpenCvSharp for the main API and data-model differences.

In most cases you do not need to reference this package directly. Use one of the all-in-one packages instead:

• Windows: OpenCvSharp5.Windows or OpenCvSharp5.Windows.Slim
• Linux: OpenCvSharp5 + OpenCvSharp5.official.runtime.linux-x64

The OpenCvSharp5.* runtime packages target OpenCV 5.x. An identically-named OpenCvSharp4.* counterpart (OpenCV 4.13.0) is also published for .NET Framework / older runtimes.

🔄 Already using OpenCvSharp4? See the Migration Guide (4 → 5) on GitHub for target framework changes, package/namespace renames, and OpenCV 5 API changes.

The Linux linux-x64 packages are built on manylinux_2_28 (glibc 2.28) and work on Ubuntu 20.04+, Debian 10+, RHEL/AlmaLinux 8+, and other Linux distributions. The full (non-slim) package includes FFmpeg (LGPL v2.1) and Tesseract statically linked.

Linux highgui dependency: The full linux-x64 package uses GTK3 for highgui (Cv2.ImShow, Cv2.WaitKey, etc.). GTK3 is pre-installed on standard Ubuntu/Debian/RHEL environments. In minimal or container environments where it is absent, install it manually:

• Ubuntu/Debian: apt-get install libgtk-3-0
• RHEL/AlmaLinux: dnf install gtk3

For headless servers or minimal containers that still need videoio, dnn, ml, contrib, stitching, etc., use the headless package (OpenCvSharp5.official.runtime.linux-x64.headless) instead: same module set as full, highgui disabled, no GTK3/X11 dependency. If the reduced slim module set (see below) is enough, that has no GUI dependencies either.

macOS: The osx.x64 and osx.arm64 packages include FFmpeg, Tesseract, Freetype, and all standard OpenCV modules, statically linked.

Available Runtime Packages

Note: OpenCvSharp5.runtime.linux-arm has been renamed to OpenCvSharp5.runtime.linux-arm64 to correctly reflect the ARM64 (AArch64) RID. The old package is kept as a compatibility shim that automatically pulls in the renamed package, but new projects should reference OpenCvSharp5.runtime.linux-arm64 directly.

Headless Profile (Linux only)

The OpenCvSharp5.official.runtime.linux-x64.headless package has the same module set as the full linux-x64 package (videoio, dnn, ml, contrib, stitching, barcode, ...) but highgui is disabled at build time, so it never links GTK3/X11 and needs no GUI dependency to be installed. Use it for containerized/headless services (e.g. an ASP.NET Core service using VideoCapture/imgcodecs) that need more than the slim module set below but never call highgui.

Slim Profile

The slim packages bundle a smaller native library with a reduced OpenCV module set:

Resources

• GitHub Repository
• OpenCvSharp5 (managed package)
• Documentation and API Reference
• Issue Tracker