Building OpenCV on Windows

OpenCV provides full support for Windows platforms with Visual Studio, MinGW, and other compilers. Pre-built binaries are also available for quick setup.

Quick Start with Pre-built Libraries

The fastest way to get started with OpenCV on Windows:

Download Pre-built Package

Download the Windows installer from the OpenCV releases page:

# Example: opencv-4.x.0-windows.exe

Pre-built packages include binaries for Visual Studio 2015-2022 (x86 and x64).

Extract Archive

Run the self-extracting archive. It will create a directory structure:

C:\opencv\
  build\
    x64\          # 64-bit binaries
      vc15\       # Visual Studio 2017
      vc16\       # Visual Studio 2019
      vc17\       # Visual Studio 2022
    x86\          # 32-bit binaries
  sources\        # Source code

Set Environment Variables

Add OpenCV to your system path:

# Set OpenCV_DIR (adjust version as needed)
setx OpenCV_DIR C:\opencv\build\x64\vc17

# Add bin directory to PATH
setx PATH "%PATH%;%OpenCV_DIR%\bin"

Restart your terminal or IDE after setting environment variables.

Building from Source

For the latest features or custom configurations, build OpenCV from source.

Prerequisites

Visual Studio
MinGW

Required:

Visual Studio 2015 or later (Community Edition is free)
- Install “Desktop development with C++” workload
CMake 3.5.1 or later
Git for Windows (optional but recommended)

Optional:

Python 3.6+ for Python bindings
NumPy for Python interface

Build Steps with Visual Studio

Clone Repository

Open Git Bash or Command Prompt:

cd C:\
git clone https://github.com/opencv/opencv.git
cd opencv

Or download and extract a release archive.

Create Build Directory

mkdir build
cd build

Configure with CMake GUI

Launch CMake GUI:

Set Source code to: C:/opencv
Set Build binaries to: C:/opencv/build
Click Configure
Select your Visual Studio version and platform (x64 recommended)
Click Finish

Enable “Grouped” view for easier navigation of CMake options.

Adjust Build Options

Key CMake options to consider:

BUILD_EXAMPLES=ON           # Build example applications
BUILD_TESTS=OFF             # Skip tests for faster build
BUILD_PERF_TESTS=OFF        # Skip performance tests
BUILD_opencv_world=ON       # Build single combined library
BUILD_SHARED_LIBS=ON        # Build DLLs (not static libs)
WITH_CUDA=OFF               # Enable if you have NVIDIA GPU
WITH_TBB=ON                 # Enable Intel TBB

Click Configure again after changes.

Generate Project Files

Once configuration completes without errors:

Click Generate
Click Open Project to launch Visual Studio

Build in Visual Studio

In Visual Studio:

Select Release configuration (or Debug)
Right-click ALL_BUILD project → Build
Wait for compilation (15-60 minutes depending on options)

Build both Release and Debug configurations if you need both.

Install (Optional)

Right-click INSTALL project → BuildThis copies files to the install directory (default: C:/Program Files/opencv).

Build Steps with Command Line

For automated builds or CI/CD pipelines:

# Clone repository
git clone https://github.com/opencv/opencv.git
cd opencv
mkdir build
cd build

# Configure
cmake -G "Visual Studio 17 2022" -A x64 ^
      -DCMAKE_BUILD_TYPE=Release ^
      -DBUILD_EXAMPLES=ON ^
      -DBUILD_opencv_world=ON ^
      ..

# Build Release
cmake --build . --config Release --target ALL_BUILD -j 8

# Build Debug
cmake --build . --config Debug --target ALL_BUILD -j 8

# Install
cmake --build . --config Release --target INSTALL

Visual Studio 2022
Visual Studio 2019
Visual Studio 2017
Ninja (Faster)

cmake -G "Visual Studio 17 2022" -A x64 ..

cmake -G "Visual Studio 16 2019" -A x64 ..

cmake -G "Visual Studio 15 2017 Win64" ..

# From Visual Studio Developer Command Prompt
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release ..
ninja

Using Git Bash for Automated Build

A complete build script using Git Bash:

#!/bin/bash -e
myRepo=$(pwd)
CMAKE_GENERATOR_OPTIONS=-G"Visual Studio 17 2022"

# Clone repositories
if [ ! -d "$myRepo/opencv" ]; then
    echo "Cloning opencv"
    git clone https://github.com/opencv/opencv.git
else
    cd opencv && git pull --rebase && cd ..
fi

if [ ! -d "$myRepo/opencv_contrib" ]; then
    echo "Cloning opencv_contrib"
    git clone https://github.com/opencv/opencv_contrib.git
else
    cd opencv_contrib && git pull --rebase && cd ..
fi

# Build
mkdir -p build_opencv
cd build_opencv

CMAKE_OPTIONS=(
    -DBUILD_PERF_TESTS:BOOL=OFF
    -DBUILD_TESTS:BOOL=OFF
    -DBUILD_DOCS:BOOL=OFF
    -DWITH_CUDA:BOOL=OFF
    -DBUILD_EXAMPLES:BOOL=OFF
    -DINSTALL_CREATE_DISTRIB=ON
    -DOPENCV_EXTRA_MODULES_PATH="$myRepo/opencv_contrib/modules"
    -DCMAKE_INSTALL_PREFIX="$myRepo/install/opencv"
)

cmake "${CMAKE_GENERATOR_OPTIONS[@]}" "${CMAKE_OPTIONS[@]}" "$myRepo/opencv"

# Build both configurations
cmake --build . --config Debug
cmake --build . --config Release

# Install
cmake --build . --target install --config Release
cmake --build . --target install --config Debug

Building with opencv_contrib

To include extra modules from opencv_contrib:

# Clone opencv_contrib alongside opencv
cd C:\
git clone https://github.com/opencv/opencv.git
git clone https://github.com/opencv/opencv_contrib.git

cd opencv\build

# Configure with contrib modules
cmake -G "Visual Studio 17 2022" -A x64 ^
      -DOPENCV_EXTRA_MODULES_PATH=C:/opencv_contrib/modules ^
      ..

Optional Dependencies

Intel Threading Building Blocks (TBB)

For improved parallel processing performance:

Download TBB from Intel oneAPI
Extract to C:\opencv\dep\tbb
Add CMake option: -DWITH_TBB=ON -DTBB_DIR=C:/opencv/dep/tbb

CUDA (NVIDIA GPU Acceleration)

Install CUDA Toolkit

Download from NVIDIA CUDA DownloadsInstall with default options.

Configure OpenCV with CUDA

cmake -G "Visual Studio 17 2022" -A x64 ^
      -DWITH_CUDA=ON ^
      -DCUDA_ARCH_BIN="6.0 6.1 7.0 7.5 8.0 8.6 8.9" ^
      ..

Set CUDA_ARCH_BIN to match your GPU’s compute capability. Build time increases significantly with CUDA enabled.

Python Support

# Install Python and NumPy
pip install numpy

# CMake will auto-detect Python
# Or specify explicitly:
cmake -DPYTHON3_EXECUTABLE="C:/Python311/python.exe" ^
      -DPYTHON3_INCLUDE_DIR="C:/Python311/include" ^
      -DPYTHON3_NUMPY_INCLUDE_DIRS="C:/Python311/Lib/site-packages/numpy/core/include" ^
      ..

Build Configuration Options

Recommended Settings for Development

BUILD_EXAMPLES=ON                    # Sample applications
BUILD_opencv_world=ON                # Single library file
BUILD_SHARED_LIBS=ON                 # DLL files
ENABLE_SOLUTION_FOLDERS=ON           # Organize VS projects
BUILD_TESTS=OFF                      # Skip tests
BUILD_PERF_TESTS=OFF                 # Skip perf tests
WITH_TBB=ON                          # Parallel processing
WITH_OPENGL=ON                       # OpenGL support

Minimal Build for Distribution

BUILD_EXAMPLES=OFF
BUILD_TESTS=OFF
BUILD_PERF_TESTS=OFF
BUILD_DOCS=OFF
BUILD_opencv_apps=OFF
BUILD_opencv_world=ON                # Recommended for easier deployment
INSTALL_CREATE_DISTRIB=ON

Setting Up Your Development Environment

Using OpenCV in Visual Studio Projects

Set Environment Variable

setx OpenCV_DIR "C:\opencv\build\x64\vc17"

Add to System PATH

setx PATH "%PATH%;%OpenCV_DIR%\bin"

Or manually add C:\opencv\build\x64\vc17\bin to System PATH via Control Panel.

Configure Your Project

In your project’s CMakeLists.txt:

find_package(OpenCV REQUIRED)
include_directories(${OpenCV_INCLUDE_DIRS})
target_link_libraries(your_target ${OpenCV_LIBS})

Or manually configure Include Directories and Library Directories in Visual Studio project properties.

Verification

Test your OpenCV installation:

Command Prompt
PowerShell

# Check Python binding
python -c "import cv2; print(cv2.__version__)"

# Run example application
cd C:\opencv\build\bin\Release
opencv_version.exe

# List built libraries
Get-ChildItem C:\opencv\build\lib\Release

# List executables
Get-ChildItem C:\opencv\build\bin\Release\*.exe

Package Manager Installation

vcpkg

For dependency management:

# Install vcpkg
git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
.\bootstrap-vcpkg.bat

# Install OpenCV
.\vcpkg install opencv[contrib,cuda]:x64-windows

# Integrate with Visual Studio
.\vcpkg integrate install

Conan

# Install Conan
pip install conan

# Install OpenCV
conan install opencv/4.5.5@

Troubleshooting

CMake cannot find Visual Studio

Ensure Visual Studio is installed with C++ tools
Use “Developer Command Prompt for VS” to run CMake
Specify generator explicitly: -G "Visual Studio 17 2022"

Missing DLL errors when running applications

Add OpenCV bin directory to PATH:

setx PATH "%PATH%;C:\opencv\build\x64\vc17\bin"

Or copy DLL files next to your executable.

Python cannot import cv2

Verify NumPy is installed: pip install numpy
Check Python version matches (32/64-bit)
Verify cv2.pyd is in Python’s site-packages
Try rebuilding with correct Python paths

Build errors with CUDA

Ensure CUDA Toolkit version matches VS version compatibility
Update GPU drivers
Reduce CUDA_ARCH_BIN to only your GPU’s compute capability

Next Steps

Visual Studio Integration

Set up OpenCV in Visual Studio projects

CMake Configuration

Explore all configuration options

Getting Started

Write your first OpenCV application

Python Bindings

Use OpenCV with Python

Getting Started

Core Concepts

Modules

Tutorials

Language Bindings

Platform Support

Building OpenCV on Windows

Quick Start with Pre-built Libraries

Building from Source

Prerequisites

Build Steps with Visual Studio

Build Steps with Command Line

Using Git Bash for Automated Build

Building with opencv_contrib

Optional Dependencies

Intel Threading Building Blocks (TBB)

CUDA (NVIDIA GPU Acceleration)

Python Support

Build Configuration Options

Recommended Settings for Development

Minimal Build for Distribution

Setting Up Your Development Environment

Using OpenCV in Visual Studio Projects

Verification

Package Manager Installation

vcpkg

Conan

Troubleshooting

Next Steps

Visual Studio Integration

CMake Configuration

Getting Started

Python Bindings

Getting Started

Core Concepts

Modules

Tutorials

Language Bindings

Platform Support

​Quick Start with Pre-built Libraries

​Building from Source

​Prerequisites

​Build Steps with Visual Studio

​Build Steps with Command Line

​Using Git Bash for Automated Build

​Building with opencv_contrib

​Optional Dependencies

​Intel Threading Building Blocks (TBB)

​CUDA (NVIDIA GPU Acceleration)

​Python Support

​Build Configuration Options

​Recommended Settings for Development

​Minimal Build for Distribution

​Setting Up Your Development Environment

​Using OpenCV in Visual Studio Projects

​Verification

​Package Manager Installation

​vcpkg

​Conan

​Troubleshooting

​Next Steps

Visual Studio Integration

CMake Configuration

Getting Started

Python Bindings

Quick Start with Pre-built Libraries

Building from Source

Prerequisites

Build Steps with Visual Studio

Build Steps with Command Line

Using Git Bash for Automated Build

Building with opencv_contrib

Optional Dependencies

Intel Threading Building Blocks (TBB)

CUDA (NVIDIA GPU Acceleration)

Python Support

Build Configuration Options

Recommended Settings for Development

Minimal Build for Distribution

Setting Up Your Development Environment

Using OpenCV in Visual Studio Projects

Verification

Package Manager Installation

vcpkg

Conan

Troubleshooting

Next Steps