Fork me on GitHub

SUPPORT

If you’re a newcomer and need help, check the documentation page.

When something fails

If you are attempting to debug an OpenCV program:

  • At first try to troubleshoot the problem using documentation and tutorials.
  • If it doesn’t help, search for an answer or ask a question at OpenCV Answers.
  • If you found a bug or wish to make a feature request, please see the section below.

Reporting issues / requesting features

  • First, check the issue tracker: Known bugs, often with patches or workarounds, are generally found there. If you have something to add to an existing bug, add it as a comment to the ticket, rather than posting to the mailing lists.
  • Then check the OpenCV mailing list archive and OpenCV Answers to see if someone else has asked your question or reported your bug.
  • If all the above steps failed, the best thing to do is to raise a ticket.

If you’re not sure what you found is a bug you can ask on OpenCV Answers. If the problem is confirmed as a bug, please create a ticket. They are preferred if you are posting about a bug because they will be reviewed by the developers.

Asking a question

Please read before posting to any of OpenCV support forums/lists!

Do Not:

  • The following are not appropriate questions:
    • general debugging/programming questions;
    • questions about software that is not related to OpenCV;
    • asking for help with your homework.
  • Don’t contact the developers/maintainers directly.
    • The community can’t see question or answer(s) not asked/answered publicly.
    • Open Source development works best when the entire community participates in discussions and helps to answer questions.
    • Send all questions to answers.opencv.org or other corresponding mailing list, and report all bugs to the bug tracker.

Do:

Be as specific as possible, with steps to reproduce. If we can reproduce the problem, we can fix it quickly.

  • Please specify your platform (Windows 32/64bit, Linux x86/x64/ppc/…, MacOSX 32/64bit/ppc); compiler version; OpenCV version/revision; whether IPP, OpenMP, MMX, SSE … have been enabled or not, and any other information that let us reproduce the environment, identify and localize the problem.
  • A sample code reproducing the problem helps us the most. Please check samples – for the preferred style (small code size, cross-platform). There is no need to provide any project files or makefiles, if it is a short single-file sample, we could build it and run in a minute.
  • Please provide the output of  cv::getBuildInformation()  function every time you report a bug about the trunk version of OpenCV. May be the problem is in your build settings, so the log can greatly help us.
  • If your application is complex, and the problem happens somewhere in the middle, often it is still possible to create a short standalone sample:
    • First, capture and store the data that you pass to the function using FileStorage.
    • Then copy the function call and put the corresponding reading from FileStorage in front of it.
  • Describe exactly what you were doing or are trying to do, and exactly what, if anything, went wrong. If you say, “OpenCV doesn’t work!” we can’t help you.
  • As appropriate, also include your:
    • backtraces;
    • relevant config files;
    • screenshots or videos to demonstrate the problem.