Troubleshooting

We are currently developing this wiki, so your feedback is precious to us. If you had an error which is not listed here, please e-mail us at [mailto:support@covii.pt support@covii.pt].

Sometimes, during the installation or even when running an application you might bump into some kind of error.

Here is a list of the most common errors and respective solution:

The sensor is not detected (or at least that's what it seems!) - "Device not found" message: 
 * First of all try to run the NIViewer application from openNI and make sure the problem is that the camera isn't found:
 * Windows -> go to c:\Program Files\OpenNI\Samples\Bin\Debug\NiViewer.exe (or Program Files (x86))
 * Mac -> go to
 * Linux -> go to
 * Make sure you don't have Microsoft's drivers installed.
 * If it's still not working
 * 1) Uninstall the current drivers (Control panel -> uninstall or change a program -> PrimeSense sensor KinectMod 5.1.2.1 for Windows XX-bit. (Maybe you should restart the computer afterwards).
 * 2) Download the file https://github.com/avin2/SensorKinect/blob/unstable/Bin/SensorKinect093-Bin-Win64-v5.1.2.1.msi (x64) or https://github.com/avin2/SensorKinect/blob/unstable/Bin/SensorKinect093-Bin-Win32-v5.1.2.1.msi (x86) and install it.
 * If you're still having problems contact our google group https://groups.google.com/forum/#!forum/viimsdk.

Having problems running ViiM samples and compiled projects - random crashes
 * One common problem is installation incompatibilities between openNI and Nite software versions. Maybe you already had some version installed before ViiM installation and that's what is causing the problem.
 * If you are having this kind of problems try uninstall ViiM, OpenNI and Nite from you computer and then reinstal ViiM ONLY, letting ViiM install OpenNI and NITE from its distribution.

ViiM SDK v1.0.x + Kinect + Windows 8 (and no Microsoft SDK!) = no camera detected (led blinks once red when connecting to pc)
 * This is a know issue about Windows 8. Luckily there's a way around it. First try the easy way:
 * -> When installing ViiM make sure Kinect is not connected. After its setup, restart your pc and then connect Kinect.
 * -> If it still only blinks once red and no green, then uninstall PrimeSense's Kinect drivers and try the following:
 * 1. Windows Key + R
 * 2. Enter shutdown.exe /r /o /f /t 00
 * 3. Click the "OK" button
 * 4. System will restart to a "Choose an option" screen
 * 5. Select "Troubleshoot" from "Choose an option" screen
 * 6. Select "Advanced options" from "Troubleshoot" screen
 * 7. Select "Windows Startup Settings" from "Advanced options" screen
 * 8. Click "Restart" button
 * 9. System will restart to "Advanced Boot Options" screen
 * 10. Select "Disable Driver Signature Enforcement"
 * 11. Once the system starts, download the x86 or the x64 version of the PrimeSense's drivers and install it.
 * 12. Restart your pc normally and then plug the Kinect in. Hopefully it will start blinking the green light.

White images, random crashes.
 * You must update the graphic card drivers to solve it.

No sensor detected on Linux.
 * We detected that if you start your Linux machine with the Asus Xtion sensor already connected, the system won't recognize the sensor. Either you start your Linux machine with the sensor unplugged, or if it is already on, plug it out and plug it again after starting Linux.

ViiM SDK v1.x.x on Visual Studio 2012: (...) Microsoft Visual Studio versions above 2010 (10.0) are not supported!
 * This error happens because openNI (version 1) doesn't get along with Visual Studio's 2012 compiler. The complete error message is:
 * XnPlatform.h(58): fatal error C1189: #error : Xiron Platform Abstraction Layer - Win32 - Microsoft Visual Studio versions above 2010 (10.0) are not supported!
 * Solve this by going to the Project Settings and changing the Platform Toolset to 2010 (in 'Configuration Properties' -> 'General').

Samples project converted to Visual Studio 2012 doesn't compile: the project ' ' has been renamed or is no longer in the solution
 * Open the file 'ViiM_OF_Samples.vcxproj' and delete the lines that add the OpenFrameworks project, as follows:

  {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx} false  


 * If you are having problems with this we advise to download a newer file for the samples version. In this newer version this problem should be solved.

The UserTracking sample sometimes crashes.
 * This sample may crash due to a bug when accessing the pixels. We are aware of this issue and it will be resolved soon.

I'm trying to run the Irrlicht samples on MacOSX and I get this error after choosing OpenGL: Using renderer: OpenGL  ''OpenGL driver version is not 1.2 or better.  Warning: OpenGL device only has one texture unit. Disabling multitexturing.  GLSL not available.''
 * This is because you have an old version of the OpenGL framework. Update your OSX through  -> Software Update...

When I try to run a sample, i get the following error: ''symbol lookup error: /usr/lib/libIrrlicht.so: undefined symbol: glXGetProcAddress


 * This means that either your graphic card or its drivers don't support the GLX 1.4 version. Because of this we will provide libIrrlicht.so for GLX 1.3 version soon.

While compiling a sample this error may happen in linux systems :

/usr/include/ni/XnStatus.h:50:67: error: two or more data types in declaration of ‘parameter’


 * Open XnStatus.h and comment lines 50, 59 and 68

When trying to run the Irrlicht samples on Linux, this error might appear: ./Viewer: symbol lookup error: /usr/lib/libIrrlicht.so: undefined symbol: glXGetProcAddress
 * Your Nvidia graphics drivers are outdated, so either you update them or download the compiled version for GLX 1.3. You can download it here: IrrlichtGLX1.3. After downloading it, change the name to libIrrlicht.so and copy it to a LD folder (e.g. /usr/lib )