Difference between revisions of "FAQ:How can I run MakeHuman from a BitBucket source clone?"

From MakeHuman Community Wiki
Jump to: navigation, search
Line 4: Line 4:
 
* You can "update" the MakeHuman directory and thereby download only the latest changes instead of having to download and unzip a big binary each time a change has been made.
 
* You can "update" the MakeHuman directory and thereby download only the latest changes instead of having to download and unzip a big binary each time a change has been made.
  
The source code is hosted on BitBucket and as version control system Mercurial is used. (see https://mercurial.selenic.com/). Downloading from BitBucket will pull a '''nightly build''' ([[FAQ:What is a nightly build?]]).
+
The full procedure with platform specific notes is documented in [[Documentation:Running_MakeHuman_from_source|Running MakeHuman from Source].
 
+
== General steps for installation ==
+
 
+
These are the steps which are needed in general
+
 
+
* Install dependencies
+
* Get a mercurial client (it's what's needed for downloading the source code). On Windows it's best to get TortoiseHg (see http://tortoisehg.bitbucket.org/download/index.html). On Linux you should find mercurial in your package manager.
+
* Download the source code
+
* Run the script for downloading assets
+
 
+
== General steps for updating ==
+
 
+
Once the installation has been made, these are the steps which is needed to get up to date with the latest version
+
 
+
* Run mercurial pull + mercurial update
+
* Run the script for downloading assets
+
* Find and remove old pyc-files
+
 
+
== Linux ==
+
 
+
The easiest platform for doing all this is linux. This is what you do for installation:
+
 
+
    sudo apt-get install python2.7 python-numpy python-opengl python-qt4 python-qt4-gl mercurial
+
    hg clone <nowiki>https://bitbucket.org/MakeHuman/makehuman</nowiki>
+
    cd makehuman
+
    hg update -C stable # or "1.0.2" or "default" or whatever branch you want to run
+
    cd makehuman
+
    python download_assets.py
+
 
+
To update:
+
 
+
    cd makehuman
+
    hg pull && hg update -C
+
    cd makehuman
+
    python download_assets.py
+
    ./cleanpyc.sh
+
    ./cleannpz.sh
+
    python compile_models.py
+
    python compile_proxies.py
+
    python compile_targets.py
+
 
+
To start makehuman:
+
 
+
    cd makehuman/makehuman
+
    python makehuman.py
+
 
+
== Windows ==
+
 
+
On windows you need to install the dependencies manually. However, in order to ease this process, there is a zip file with all that is needed, see http://files.jwp.se/makehuman.html . Another option is to install Python 2.7 from the WinPython project (see http://sourceforge.net/projects/winpython/files/WinPython_2.7/). It is recommended to use the 32bit version of WinPython.
+
 
+
To install:
+
 
+
* Install everything in the zip file above. There is a readme in the file with instructions.
+
* Create a directory "makehuman" (or whatever you want to call it).
+
* Right-click the directory and choose tortoisehg ... clone
+
* Paste <nowiki>https://bitbucket.org/MakeHuman/makehuman</nowiki> in the text box for source
+
* Open your directory and the "makehuman" subdir which is now inside it
+
* Double-click "download_assets.py"
+
 
+
To update:
+
 
+
* Right-click the directory and choose tortoisehg ... update
+
* Open your directory and the "makehuman" subdir which is inside it
+
* Double-click "download_assets.py"
+
 
+
To run:
+
 
+
* Open your directory and the "makehuman" subdir which is inside it
+
* Double-click "makehuman.py"
+
 
+
== Mac ==
+
 
+
Unfortunately no-one of the devs run Mac. You will have to figure out the procedure on your own given the above.
+
 
+
If you have managed to make an installation this way, pasting the procedure here would be a good deed.
+
 
+
== Tutorial video ==
+
 
+
There is a tutorial video on how to make a "full" installation of MakeHuman and related tools on windows. This is up to date apart from the location of the zip file which is mentioned above.
+
 
+
{{#ev:youtube|3CCHGX-6Mtk}}
+

Revision as of 08:40, 31 May 2016

Contrary to popular opinion it is not all that difficult to run MakeHuman directly from source. Doing so has the following benefits:

  • You get full access to all assets (i.e. you are not restricted to only compiled/processed/compressed versions)
  • You can "update" the MakeHuman directory and thereby download only the latest changes instead of having to download and unzip a big binary each time a change has been made.

The full procedure with platform specific notes is documented in [[Documentation:Running_MakeHuman_from_source|Running MakeHuman from Source].