View source for Download And Installation

==Windows==
===Nuget===
Using nuget package manager is probably the easiest way to include Emgu CV library in your project. 
====Open Source Release====
*From your project, right click on "References" and select "Manager Nuget Packages..." option. It will open up nuget package manager. In package source, make sure that "nuget.org" is selected. (If you are using the commercial release, please check the instruction in the commercial download area for instructions to setup the commercial release nuget repository.)

*Under "Browse", enter the search text "emgu.cv.runtime" and you should be able to find the Emgu.CV.runtime.windows nuget package. 
[[File:install_EmguCV_Nuget.png| 600px]]

Please make sure the package is created by "Emgu Corporation" for the official release.

*Click the "Install" button. Nuget will download Emgu.CV.runtime.windows and configure the project for you.

====Commercial Release====
*If you are using the commercial release, please check the instruction in the commercial download area for instructions to setup the commercial release nuget repository.

*Commercial release download link can be found in the "Download Instructions" at the bottom of your purchase complete page. It is also available on the product delivery email, under the "CUSTOMER SERVICE" session, it appears as a link under "Your Order Data". Please click on the link to access the Commercial release download session.

*If you have the Professional / Ultimate license. The instruction can be found in "windows/nuget.txt" file. 

*If you have the Windows only license. The instructions can be found in "nuget.txt" file
 
*Once the commercial nuget repository is set up, you can browse it, there should be two packages: Emgu.CV.runtime.windows-CR is the commercial release runtime without CUDA; Emgu.CV.runtime.windows.cuda-CR is the commercial release runtime with CUDA support. 

*Click the "Install" button. Nuget will download Emgu CV commercial release and configure the project for you.

===Using the Downloadable packages===
If you are using the downloadable packages (.zip or .exe), you can follow the instructions below.

====Getting the Dependency====
*For Version 3.0+, the required vcrt dlls are included in the "x86" and "x64" folder. You will be ready as long as you copy all the unmanaged dlls in the "x86" and "x64" folder to the folder of executable.
*For version 2.4.x the bundled OpenCV binary is build with Visual Studio 2010, you will needs to installed '''[http://www.microsoft.com/en-us/download/details.aspx?id=8328 MSVCRT 9.0 SP1 x86]''' or '''[http://www.microsoft.com/en-us/download/details.aspx?id=13523 MSVCRT 9.0 SP1 x64]''' to resolve the dependency issue.
*For Version 2.0 - 2.3, the bundled OpenCV binary is build with Visual Studio 2008, you will needs to installed '''[http://www.microsoft.com/downloads/details.aspx?familyid=A5C84275-3B97-4AB7-A40D-3802B2AF5FC2&displaylang=en MSVCRT 9.0 SP1]''' to resolve the dependency issue.
*For Version 1.5, the bundled OpenCV pre1.1 binary is build with Visual Studio 2005, you will needs to installed '''[http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en MSVCRT 8.0 SP1]''' to resolve the dependency issue.

====Building the Examples====
*Follow [http://sourceforge.net/project/showfiles.php?group_id=216500 this link] to the file server on Source Forge.
*Download and extract the windows installer. 
*Install the software
*Go to the "Solution\Windows.Desktop" folder.
*Open <code>Emgu.CV.Example.sln</code> and build the solution. At this point, you should be able to run the example programs.

====Creating a New Project in Visual Studio====
To use the framework in Visual Studio, you need to
* Download and extract the binary files package '''Emgu.CV.Windows.Binary-{version}.zip''' 
For a Full guide to using the dependencies under Visual Studio and C# see the [[Setting_up_EMGU_C_Sharp| C# Tutorial]].

=====Core Functionality=====
======Managed Code======
*Create a new Visual Studio project or use an existing one
*Add reference
**For 4.2 release. Add the <code>Emgu.CV.World.NetStandard.dll</code> to ''Reference''. Add <code>Emgu.CV.Runtime\Windows\Emgu.CV.Runtime.Windows</code> shared project to include the native dlls into your project.
**For 3.1 release. Add the <code>Emgu.CV.World.dll</code> to ''Reference'' of the project. 
**For 3.0 release. Add the two files <code>Emgu.Utils.dll</code> and <code>Emgu.CV.dll</code> to ''References'' of the project.
*Optionally put the following lines in the top of your code to include the Emgu.CV namespace.
<code>
using Emgu.CV;

using Emgu.CV.Structure;
</code>

======Open CV unmanaged dll======
*For Emgu CV 4.2 and above, adding <code>Emgu.CV.Runtime\Windows\Emgu.CV.Runtime.Windows</code> shared project to your project will take care of deploying all the native files.
*For older releases, copy the "x86" and "x64" folder, along with the DLLs inside those folder to the folder of the executable. Emgu CV is able to load the unmanaged binary from the "x86" folder when running in 32bit mode, and load the unmanaged binary from the "x64" folder when running in 64bit-mode. If you are only targeting the "x64" platform, you only need to copy the "x64" folder.

======CUDA (GPU) package======
*For Emgu CV 4.2 and above, adding <code>Emgu.CV.Runtime\Windows\Emgu.CV.Runtime.Windows</code> shared project to your project will take care of deploying all the native files.
*For Emgu CV 3.x+, only package containing ''-cuda'' in its name (e.g. <code>libemgucv-xxx-cuda-xxx</code> ) has CUDA processing enabled. 
**Install the [https://developer.nvidia.com/cuda-downloads latest cuda graphic card driver] from NVIDIA on your development workstation.
**Adding reference: For 3.1 release. You don't need to add extra references. The Cuda namespace is part of the Emgu.CV.World.dll; For 3.0 release. Add <code>Emgu.CV.Cuda.dll</code> to ''References'' 
**Optionally put the following lines in the top of your code to include the Emgu.CV.Cuda  namespace. <code> using Emgu.CV.Cuda;</code>

*For Emgu CV 2.x, CUDA (GPU) for image processing is only available for [[Version_History#Emgu.CV-2.2.1|Emgu CV rev 2.2.1]] and later. Only package containing ''-gpu'' in its name (e.g. <code>libemgucv-xxx-gpu-xxx</code>) has CUDA (GPU) processing enabled. 
**Install the [https://developer.nvidia.com/cuda-downloads latest cuda graphic card driver] from NVIDIA on your development workstation.
**Add <code>Emgu.CV.GPU.dll</code> to ''References'' 
**Optionally put the following lines in the top of your code to include the Emgu.CV.GPU namespace. <code> using Emgu.CV.GPU;</code>

=====GUI=====
To display image using Emgu's [[ImageBox]]
*Add <code> Emgu.CV.UI.dll</code> to ''References''
*Optionally put the following lines in the top of your code to include the Emgu.CV.UI namespace.
<code> using Emgu.CV.UI;</code>

=====Machine Learning=====
*Adding reference
** For 3.1 release. You don't need to add extra reference.
** For release up to and including 3.0 release, add <code>Emgu.CV.ML.dll</code> to ''References'' 
*Optionally put the following lines in the top of your code to include the Emgu.CV.ML namespace.
<code> using Emgu.CV.ML;</code>

=====Start Developing=====
*Follow the [[Tutorial]] to learn how to use Emgu CV. 
*Hello World ([[Hello_World_in_CSharp |C#]] or [[Hello_World_in_VB.NET |VB .NET]]) is a good starting point.

====The type initializer for 'Emgu.CV.CvInvoke' threw an exception.====
If you see this exception, please check the following

===== Have you installed MSVCRT? =====
* For Version 3.0+, the required vcrt dlls are included in the "x86" and "x64" folder. You will be ready as long as you copy all the unmanaged dlls in the "x86" and "x64" folder to the folder of executable.
*For Version 2.4+, the bundled OpenCV binary is build with Visual Studio 2010, you will needs to installed '''[http://www.microsoft.com/en-us/download/details.aspx?id=5555 MSVCRT 10.0 SP1 x86]''' or '''[http://www.microsoft.com/en-ca/download/details.aspx?id=13523 MSVCRT 10.0 SP1 x64]''' to resolve the dependency issue.
*For Version 2.0+, the bundled OpenCV binary is build with Visual Studio 2008, you will needs to installed '''[http://www.microsoft.com/downloads/details.aspx?familyid=A5C84275-3B97-4AB7-A40D-3802B2AF5FC2&displaylang=en MSVCRT 9.0 SP1]''' to resolve the dependency issue.
*For Version 1.5, the bundled OpenCV pre1.1 binary is build with Visual Studio 2005, you will needs to installed '''[http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en MSVCRT 8.0 SP1]''' to resolve the dependency issue.

===== Have you copied the [[OpenCV]] dlls to the execution directory? =====
* Make sure the unmanaged DLLs are in the execution directory. 
**For Emgu CV version >=2.4.2, this means the "x86" and "x64" folder and all the dlls within the folders. The folder names and file structures should not be altered when deploying with the application. 
**For EMGU CV version 2.4 <code>cudart64_42_9.dll, cvextern.dll, npp64_42_9.dll, opencv_calib3dXXX.dll, opencv_contribXXX.dll, opencv_coreXXX.dll, opencv_features2dXXX.dll, opencv_flannXXX.dll, opencv_highguiXXX.dll, opencv_imgprocXXX.dll, opencv_legacyXXX.dll, opencv_mlXXX.dll, opencv_nonfreXXX.dll, opencv_objectdetectXXX.dll, opencv_videoXXX.dll,</code?> where <code>XXX</code> is the OpenCV version number. 
**For Emgu CV version 2.2, 2.3 this means the following dlls: <code>opencv_calib3dXXX.dll, opencv_contribXXX.dll, opencv_coreXXX.dll, opencv_features2dXXX.dll, opencv_highguiXXX.dll, opencv_imgprocXXX.dll, opencv_legacyXXX.dll, opencv_mlXXX.dll, opencv_objectdetectXXX.dll, opencv_videoXXX.dll</code> where <code>XXX</code> is the OpenCV version number. 
**For Emgu CV version <= 2.1, this means the following dlls:<code>cvXXX.dll, cvauxXXX.dll, cxcoreXXX.dll, highguiXXX.dll, opencv_ffmpegXXX.dll, mlXXX.dllcvextern.dll</code> where <code>XXX</code> is the OpenCV version number.

*The best way to set up your project is:
**Copy the unmanaged DLLs to your project folder
**Right click on the project, click Add->Existing Item and select all unmanaged DLLs. Add them to the project. 
**For each of the included Dlls, left click on it, find the "Copy to Output Directory" option and select "Copy if newer"

===== Are you missing any dependency? =====
Download [http://www.dependencywalker.com/ Dependency Walker] and use it to open the "cvextern.dll" file. Check if any dependency is missing.

===== I have checked all of above but I still got the Exception =====
In this case, please try to [[Download And Installation#Building the Examples | build and run the examples]]. After building the examples, try to run the "Hello World" Program. 

If "Hello World" runs without any problem, compare it with you project, find the difference in configuration and fix it.

If "Hello World" get the same "The type initializer for 'Emgu.CV.CvInvoke' threw an exception." message, try to find out the '''InnerException''' and report it to the [http://www.emgu.com/forum discussion forum]

===Building from Git===
If you wants to build the development version of Emgu CV from source code, you can to get it from GIT following instructions on [[GIT | This page]].

==== Prerequisite ====
*You will need to install '''[http://www.cmake.org/cmake/resources/software.html CMAKE]''' in-order to build the unmanaged C++ code (OpenCV and  cvextern.dll).
*You will need '''Visual Studio 2017'''/ '''Visual Studio 2015''' to build the Managed code (Emgu CV)

==== Configuring the project ====
===== 32-Bit Windows =====
Run <code>Build_Binary_x86_nocuda.bat</code> script located in the <code>platforms\windows</code> folder of GIT.
===== 64-Bit Windows =====
Run <code>Build_Binary_x86-64_doc.bat</code> script located in the <code>platforms\windows</code> folder of GIT.

==== Building the unmanaged code ====
Double check if the <code>emgucv.sln</code> file exists in the root folder, if not, run the above step again.
Open <code>emgucv.sln</code> solution located in the root folder with the matching version of Visual Studio, switch the configuration to "Release" and build the cvextern project. 

==== Building the managed code ====
*Browse to the "Solution\Windows.Desktop" Folder
*Open <code>Emgu.CV.sln</code> and build the solution.
At this point, the Emgu CV dlls should be available under the <code>bin</code> folder in the top most directory.

==Linux==
===Getting ready===
====Fedora 21====
* [[OpenCV]]
** We will build a custom version of OpenCV in the next step. It is recommended to remove any OpenCV package if it is installed on your machine. You should remove OpenCV by running as root <pre> yum remove opencv </pre> 

* [[Mono]]
** You will need [[Mono]].
** [[Emgu CV]] library use WCF (Windows Communication Foundation) and therefore also requires mono-wcf.  

* CMake
[[Emgu CV]] has adapted to use cmake to compile all it source code (as well as [[OpenCV]]). Make sure you have cmake installed.

* Installing GIT so you can check out the project folder, you can install GIT by running as root <pre>yum install git</pre>

====Ubuntu 16.04====
* [[Mono]]
** You will need [[Mono]] >= 2.6
** [[Emgu CV]] library use WCF (Windows Communication Foundation) and therefore also requires libmono-wcf3.0-cil. 
* [[OpenCV]]
** We will build a custom version of OpenCV in the next step. It is recommended to remove any OpenCV package if it is installed on your machine. 
* CMake
[[Emgu CV]] has adapted to use cmake to compile its source code (as well as [[OpenCV]]). 
* Installing GIT so you can check out the project folder, you can install GIT by running <pre>sudo apt-get install git</pre>

====Raspbian (Raspberry Pi)====
* [[Mono]]
** You will need [[Mono]] >= 2.6
** [[Emgu CV]] library use WCF (Windows Communication Foundation) and therefore also requires libmono-wcf3.0-cil. 
* [[OpenCV]]
** We will build a custom version of OpenCV in the next step. It is recommended to remove any OpenCV package if it is installed on your machine. 
* CMake
[[Emgu CV]] has adapted to use cmake to compile its source code (as well as [[OpenCV]]). 
* Installing GIT so you can check out the project folder, you can install GIT by running <pre>sudo apt-get install git</pre>

===Getting the source code===
*To build from source, you will need a Git client to check out the source code from SourceForge. For more information, see [[GIT]]. The following command can be used to check out the source:
<pre>git clone https://github.com/emgucv/emgucv emgucv </pre>
*Go to emgucv directory
<pre>cd emgucv</pre>

*Initialize opencv, tesseract-ocr and cvblob submodules
<pre>git submodule update --init --recursive</pre>

===Configuring the project===
====Fedora 21====
*Got to the configuration folder
<pre>cd platforms/fedora/21</pre>
*Installing the perquisites
This only needs to be run once. You can install the prerequisites by running <pre>./install_dependency</pre>
*Use the following command to configure the project:
<pre>./cmake_configure</pre>
*Go back to the source code root folder
<pre>cd ../../..</pre>

====Raspbian (Raspberry Pi)====
*Got to the configuration folder
<pre>cd platforms/raspbian</pre>
*Installing the perquisites
This only needs to be run once. You can install the prerequisites by running <pre>./apt_install_dependency</pre>
*Use the following command to configure the project:
<pre>./cmake_configure</pre>
*Go back to the source code root folder
<pre>cd ../..</pre>

====Ubuntu====
*Got to the configuration folder
<pre>cd platforms/ubuntu/18.04</pre>
*Installing the perquisites
This only needs to be run once. You can install the prerequisites by running <pre>./apt_install_dependency</pre>
*Use the following command to configure the project:
<pre>./cmake_configure</pre>

===Build the binary===
*Build [[Emgu CV]] by calling 
<pre>make</pre>

Sit back and wait as this will build [[OpenCV]], as well as cvextern.so, Emgu.CV.World.NetStandard.dll

===Running the Examples===
*Now go to the bin folder 
<pre>cd bin</pre>
*make sure mono can load the dynamic library from the current location by typing
<pre>export LD_LIBRARY_PATH=.:$LD_LIBRARY_PATH</pre>
*Try to run the example 
<pre>mono Example.PlanarSubdivision.monoexe</pre>

You should see the planar subdivision window
*Follow the instruction on [[Compiling with Monodevelop]], as the environment has been setup by cmake

=== System.DllNotFoundException ===
If you encounter this exception during 
<pre>mono Example.PlanarSubdivision.monoexe</pre>
Your OpenCV build might be incomplete (e.g. GTK+ 2.x devel library is missing). To trace the cause of the error, run <pre>MONO_LOG_LEVEL=debug mono Example.PlanarSubdivision.monoexe</pre> and exam the error message.

===Building Installable Package===
====RPM Package for Fedora 15====
*Make sure [[Download_And_Installation#Fedora 15|the dependency]] is satisfied. 
*Make sure you have the rpm-build package installed. You can do this by running as root <pre>yum install rpm-build</pre>
*Check out the source from SVN and go the the emgucv source folder
*Configure the package with <pre>cmake -DBUILD_NEW_PYTHON_SUPPORT:BOOL=FALSE -DEMGU_CV_EXAMPLE_BUILD:BOOL=FALSE -DBUILD_TESTS:BOOL=FALSE -DBUILD_DOCS:BOOL=FALSE .</pre>
*Create a rpm package by running as root <pre>make package</pre>
*You should get a libemgucv-{VERSION}.{SUBVERSION}-{arch}.rpm file which includes
** OpenCV library and documentations
** Emgu CV library and its dependencies (including ZedGraph and zlib.net)

====Debian Package for Ubuntu 11.04====
*Make sure [[Download_And_Installation#Ubuntu_11.04|the dependency]] is satisfied. 
*Check out the source from SVN and go to the emgucv source folder
*Configure the package with <pre>cmake -DBUILD_NEW_PYTHON_SUPPORT:BOOL=FALSE -DEMGU_CV_EXAMPLE_BUILD:BOOL=FALSE -DBUILD_TESTS:BOOL=FALSE -DBUILD_DOCS:BOOL=FALSE .</pre>
*Create a debian package with <pre>sudo make package</pre>
*You should get a libemgucv-{VERSION}.{SUBVERSION}-{arch}.deb file which includes
** OpenCV library and documentations
** Emgu CV library and its dependencies (including ZedGraph)

== Mac OS ==
Emgu CV for Mac OS is available under our commercial license. The instructions below applies to the Emgu CV for Mac OS, Professional or Ultimate commercial release.

=== Adding Emgu CV to your Xamarin Mac App ===
The "libs" folder of the Mac OS (or Pro) release package should contains the files
<pre>Emgu.CV.World.NetStandard.dll</pre>
<pre>osx/libcvextern.dylib</pre>
Please add Emgu.CV.World.NetStandard.dll as a reference to your Xamarin Mac App. Deploy "libcvextern.dylib" file to the folder of executable. Then you are ready to use Emgu CV in your Mac OS App.

If the files does not exist, you can compile the visual studio solution under "Solution\Mac\Emgu.CV.Mac.Example.sln" to build the dlls.

=== Demos ===
The demo solution is available under the "Solution\Mac" folder.

== iOS ==
Emgu CV for iOS is only available under our commercial license. The instructions below applies to the Emgu CV for iOS, Professional or Ultimate commercial release.

=== Adding Emgu CV to your Xamarin iOS App ===
The "libs" folder of the iOS (or Pro) release package should contains the file 
<pre>Emgu.CV.World.IOS.dll</pre>
Adding this dll file as a reference to your Xamarin iOS App should allow you to use Emgu CV in your App.

=== Size of the binary ===
The "Emgu.CV.World.IOS.dll" file size is large. For example, in the 3.4.1 iOS release, this file is 256MB. It contains the native binary for all supported CPU architectures, including those for simulators. 
 
However, if you are building an IPA for app store submission, and is only targeting ARM64 devices, you can select just ARM64 architecture. When the IPA is build, the compiler will strip out all the binary that are not used. It will significantly reduce the final size of the IPA. Depends on the number of functions you used, if you are only targeting a single ARM64 architecture, the final IPA size should be some where around 30-40MB.

=== Demos ===
The demo solution is available under the "Solution\iOS" folder.  

== Android ==
Emgu CV for Android is only available under our commercial license. The instructions below applies to the Emgu CV for Android, Professional or Ultimate commercial release.

=== Adding Emgu CV to your Xamarin Android App ===
The "libs" folder of the Android (or Pro) release package should contains the files
<pre>Emgu.CV.World.NetStandard.dll</pre>
<pre>Emgu.CV.Runtime.Android.dll</pre>
Adding this dll file as a reference to your Xamarin Android App should allow you to use Emgu CV in your App.

If the files does not exist, you can compile the visual studio solution under "Solution\Android\Emgu.CV.Android.sln" to build the dlls.

=== Size of the binary ===
The "Emgu.CV.World.Android.dll" file size is large. For example, in the 3.4.1 Android release, this file is 70MB. It contains the native binary for all supported CPU architectures. 
 
However, if you are building an app for Google Play Store submission, and is only targeting armeabi-v7 devices, you can select just armeabi-v7 architecture. When the final APK is build, the compiler will strip out all the binary for the architectures that are not used. It will significantly reduce the final size of the APK. Depends on the number of functions you used, if you are only targeting a single armeabi-v7 architecture, the final APK size should be some where around 20-30MB.

=== Demos ===
The demo solution is available under the "Solution\Android" folder.