FAQ:MakeHuman fails to start in windows, nothing seems to happen when I click the exe

From MakeHuman Community Wiki
Revision as of 07:39, 20 May 2016 by Joepal (Talk | contribs)

Jump to: navigation, search

For nightly builds and 1.1.0

In more cases than not, this is a crash in your graphics card drivers rather than in MakeHuman as such. It is caused by a faulty or old implementation of OpenGL, something which is particularly common in integrated Intel graphics cards. You can try to upgrade the graphics card drivers to see if it helps.

Another possible remedy is running MakeHuman with the --noshaders switch. See FAQ:MakeHuman renders odd colours and weird transparency artefacts. Can you help me?.

In order to make sure that it is the indeed the graphics card that is causing the problem, look in your log (see FAQ:How to provide a makehuman log for a good bug report?). If the log file is only a few lines long rather than a screen page or more, but there is no particular error message at the end, then it is most likely the graphics card driver that crashed.

Unfortunately, there is not a whole lot MakeHuman can do about faulty graphics card drivers.

Alternative explanations

Other possible reasons for this and similar problems may include:

  • Your antivirus quarantined a particular library in the downloaded zip. We've got reports that norton antivirus dislikes numpy for example. If this happens, random consequences ensue.
  • You have a very odd character encoding in your system and an uninterpretable character in the pathname. We think we have fixed most of these issues, but to test if this is indeed the problem, try putting makehuman in a path with only ASCII (a-z) characters, such as c:\makehuman.

For version 1.0.2 and earlier

Under the following conditions:

  1. You are using any version of windows
  2. You have downloaded a zip file containing the release build 1.0.2 or earlier (ie, not a nightly build).
  3. You have previously installed python
  4. Other factors as yet unidentified (by seemingly more rare going forward)

... MakeHuman will crash before anything appears on screen. The reason is that there is a bundled python inside the build zips, but unfortunately a system-wide installation can, under certain circumstances, get detected first. This makes python look in the wrong place for DLLs etc, which causes the exe for the build to silently crash.

There are several alternative work-arounds proposed for this. However, the simplest solution is the first one.

  1. Upgrade to 1.1.0. The problem is fixed in that branch since years back.
  2. Temporarily rename your python directory to something other than its directory path in your path statement.
  3. Uninstall the existing python from the machine (fairly extreme).
  4. Run source checkouts from bitbucket instead. In this case you must have python installed on the machine.