Difference between revisions of "Documentation:Installing MakeHuman"

From MakeHuman Community Wiki
Jump to: navigation, search
(Created page with "==== Installable versions of MakeHuman™ are available for Windows, Mac OS X and Linux. ==== The installable versions of the current!LINK!http://www.makehuman.org/content/do...")
 
 
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
==== Installable versions of MakeHuman™ are available for Windows, Mac OS X and Linux. ====
+
MakeHuman can be downloaded here [http://www.makehumancommunity.org/content/downloads.html]. Later in the development life cycle, it might make sense to download nightly builds, which are found here: [http://download.tuxfamily.org/makehuman/nightly/].
 +
Nightly represent the latest developmental updates and are not guaranteed to be stable.
  
The installable versions of the current!LINK!http://www.makehuman.org/content/download_makehuman_102.html -- stable !/LINK!!LINK!http://www.makehuman.org/content/download_makehuman_102.html -- release!/LINK!of MakeHuman are available for downlaod, as are!LINK!http://www.makehuman.org/content/download_nightlybuild.html -- nightly builds!/LINK! representing the latest deveopmental updates (not guaranteed stable) for the same platforms.
+
Currently, the latest release is MakeHuman 1.2.0.  For version 1.2.0, you can go directly to [http://www.makehumancommunity.org/content/makehuman_120.html] where you can find links for the release notes, the downloads for various platforms, and a list of know issues.  If you are also a Blender user, the tools in this MakeHuman version are designed to to work with Blender 2.83 or later.
  
==== System Requirements ====
+
== System Requirements ==
  
You will need about 250 MB of disk space.  In order to use some realtime materials and obtain the best from the internal rendering engine, it's required an average quality graphic card, produced after the year 2006.  In general, your graphics card should support OpenGL Shading Language (GLSL) version 1.2 or above.  There have been reports that the model colors are corrupted on some older Intel Graphics cards (often appearing blue and black).  If you experience this, a possible work-around is to start MakeHuman™ with the "-noshaders" command line switch.  On Windows, this switch can be added to your shortcut.
+
You will need about half a gigabyte of free disk space.  
  
==== Choice of Installation Directory ====
+
In order to use some realtime materials and obtain the best from the internal rendering engine, it's required an average quality graphic card, produced after the year 2006. In general, your graphics card should support OpenGL Shading Language (GLSL) version 1.2 or above. There have been reports that the model colors are corrupted on some older Intel Graphics cards (often appearing blue and black).  If you experience this, a possible work-around is to start MakeHuman™ with the "--noshaders" command line switch.  On Windows, this switch can be added to your shortcut. See also [[FAQ:MakeHuman renders odd colours and weird transparency artefacts. Can you help me?]]
  
The preferred install location location for MakeHuman is a directory simply named "MakeHuman", but in practice you can use another meaningful name. if it is constructed of ASCII characters.  On Windows, C:\Makehuman would make a good choice, and on Linux-alike OS's ~/MakeHuman would make a good choice.  Program data is written to the user's home directory by default, and not to the program install directory. Thus, it is not essential that users have write privledges to the program install directory. 
+
== Windows 10/11 ==
One caution on Windows systems is that the installation directory should not contain non-ASCII characters as this has been reported to cause problems for some users. This also implies that if your username includes non-ASCII letters that the desktop and Docuemts folders will not be appropriate places for installation because they would result in a path containing non-ASCII cahracters [e.g., C:\users\Åke\MakeHuman or C:\users\Desktop\Åke\MakeHuman are likely to cause problems).
+
  
==== Windows ====
+
Download the zip file from the from the download page [http://download.tuxfamily.org/makehuman/releases/makehuman-community-1.2.0-windows.zip download page]. From within Windows Explorer, double click the downloaded zip file, and click "Extract All" to extract the compressed files.  When the extracted folder opens, double click "makehuman-community-1.2.0-windows.exe" to install the program.  Allow installation on the dialog that pops up.  Click Next. 
  
Download the zip file (or the installer, if available) from the from the download page (!LINK!http://makehuman.org/content/download.html -- http://makehuman.org/content/download.html!/LINK!).
+
Choose "Install for anyone using the computer" if you want all users of your computer to have access to MakeHuman; otherwise, choose "install for just me" and click Next. This choice will affect where MakeHuman assets are saved.  If you choose "Install for just me", the default program location is: C:\Users\%USERNAME%\AppData\Local\makehuman-community.  If you choose "Install for all users", the default program location is: C:\Program Files\makehuman-community. Click Finish. There should be a shortcut to start MakeHuman on both the desktop and within the startup folder.
* Installer (not available yet): just run it. The application will be accessible from the Start menu.
+
* Zip arhive: just to unzip it where you prefer, and double click on makehuman.exe to start the application.
+
  
==== Mac OS X ====
+
In all cases, MakeHuman related assets should by default be found in:
 +
C:\Users\%USERNAME%\Documents\makehuman\v1py3. 
 +
Or, if you have OneDrive enabled, this may be"
 +
"C:\Users\%USERNAME%\OneDrive\Documents\makehuman\v1py3", instead.
  
Download and run the installer (or the zip file) from the from the download page (!LINK!http://makehuman.org/content/download.html -- http://makehuman.org/content/download.html!/LINK!). Once downloaded, mount the disk image and drag the MakeHuman app into your Applications folder. MakeHuman™ supports Snow Leopard and newer.
+
If you are using Blender 2.83 or beyond, you may also wish to install some helpful plugins for using MakeHuman with Blender.  Start Blender and choose, Edit | Preferences | Add-ons and click the Install button at the top.  Navigate to the folder where you extracted the downloaded MakeHuman and go into the folder addons_for_blender_28x, click to select makehuman-plugins-for-blender.zip, makeclothes2.zip, makeskin.zip, and maketarget2.zip. Click Install Add-on. Click the check box to make this plugin available from within Blender. As desired, repeat the process for the makeclothes2.zip, the makeskin.zip, and the maketarget2.zip plugins.  With the cursor over the Blender 3D viewport, press "N" to reveal tabs on the right side of the viewport for accessing these tools.
  
==== Linux ====
+
== Mac OS X ==
  
Installers are avaiaible for debian (E.g Ubuntu, Debian etc.) and rpm based distributions (E.g Red-hat, Suse etc.).  Please use the appropriate package for your distribution.
+
Download the DMG file from the [http://www.makehuman.org/download.php download page]. Once downloaded, mount the disk image and drag the MakeHuman app into your Applications folder. MakeHuman supports Snow Leopard and newer.
If you do not want to use the prebuilt packages or are having trouble with the packages refer to "Installing from source" below.
+
  
==== Installing from source ====
+
== Linux ==
  
If you want to install from source or are having trouble with the prepackaged binaries; Makehuman provides compressed source packages. These will work on all supported platforms provided all dependencies are satisfied. To execute MakeHuman simply run makehuman.py located in your unzipped makehuman source directory.
+
At the point of writing this, the newest stable release is only available via PPA, see [https://launchpad.net/~makehuman-official/+archive/ubuntu/makehuman-11x]. This should work on all debian derivatives.
For dependencies and libraries, please read the section "!LINK!http://www.makehuman.org/doc/node/libraries_and_build_procedures.html -- Libraries and build procedures!/LINK!".
+
Other Linux distributions will need to run from source.
 +
 
 +
== Installing from source ==
 +
 
 +
If you want to play around with the code, follow the latest development, or are having trouble with the prepackaged binaries you can run from a source clone from [https://github.com/makehumancommunity/makehuman GitHub]. This requires that you have installed python 3. and a set of other dependencies. See [[Documentation:Running_MakeHuman_from_source]] for more information.

Latest revision as of 17:02, 23 April 2022

MakeHuman can be downloaded here [1]. Later in the development life cycle, it might make sense to download nightly builds, which are found here: [2]. Nightly represent the latest developmental updates and are not guaranteed to be stable.

Currently, the latest release is MakeHuman 1.2.0. For version 1.2.0, you can go directly to [3] where you can find links for the release notes, the downloads for various platforms, and a list of know issues. If you are also a Blender user, the tools in this MakeHuman version are designed to to work with Blender 2.83 or later.

System Requirements

You will need about half a gigabyte of free disk space.

In order to use some realtime materials and obtain the best from the internal rendering engine, it's required an average quality graphic card, produced after the year 2006. In general, your graphics card should support OpenGL Shading Language (GLSL) version 1.2 or above. There have been reports that the model colors are corrupted on some older Intel Graphics cards (often appearing blue and black). If you experience this, a possible work-around is to start MakeHuman™ with the "--noshaders" command line switch. On Windows, this switch can be added to your shortcut. See also FAQ:MakeHuman renders odd colours and weird transparency artefacts. Can you help me?

Windows 10/11

Download the zip file from the from the download page download page. From within Windows Explorer, double click the downloaded zip file, and click "Extract All" to extract the compressed files. When the extracted folder opens, double click "makehuman-community-1.2.0-windows.exe" to install the program. Allow installation on the dialog that pops up. Click Next.

Choose "Install for anyone using the computer" if you want all users of your computer to have access to MakeHuman; otherwise, choose "install for just me" and click Next. This choice will affect where MakeHuman assets are saved. If you choose "Install for just me", the default program location is: C:\Users\%USERNAME%\AppData\Local\makehuman-community. If you choose "Install for all users", the default program location is: C:\Program Files\makehuman-community. Click Finish. There should be a shortcut to start MakeHuman on both the desktop and within the startup folder.

In all cases, MakeHuman related assets should by default be found in: C:\Users\%USERNAME%\Documents\makehuman\v1py3. Or, if you have OneDrive enabled, this may be" "C:\Users\%USERNAME%\OneDrive\Documents\makehuman\v1py3", instead.

If you are using Blender 2.83 or beyond, you may also wish to install some helpful plugins for using MakeHuman with Blender. Start Blender and choose, Edit | Preferences | Add-ons and click the Install button at the top. Navigate to the folder where you extracted the downloaded MakeHuman and go into the folder addons_for_blender_28x, click to select makehuman-plugins-for-blender.zip, makeclothes2.zip, makeskin.zip, and maketarget2.zip. Click Install Add-on. Click the check box to make this plugin available from within Blender. As desired, repeat the process for the makeclothes2.zip, the makeskin.zip, and the maketarget2.zip plugins. With the cursor over the Blender 3D viewport, press "N" to reveal tabs on the right side of the viewport for accessing these tools.

Mac OS X

Download the DMG file from the download page. Once downloaded, mount the disk image and drag the MakeHuman app into your Applications folder. MakeHuman supports Snow Leopard and newer.

Linux

At the point of writing this, the newest stable release is only available via PPA, see [4]. This should work on all debian derivatives. Other Linux distributions will need to run from source.

Installing from source

If you want to play around with the code, follow the latest development, or are having trouble with the prepackaged binaries you can run from a source clone from GitHub. This requires that you have installed python 3. and a set of other dependencies. See Documentation:Running_MakeHuman_from_source for more information.