zturtleman/mm3d-build-linux.md

## mm3d-build-linux.md

      
    Raw
  

              mm3d-build-linux.md
            
          
    Maverick Model 3D
GNU/Linux build dependencies and build steps are listed in the readme.
Though this does assume some knowledge about Unix terminal, git version control, and building C++ software.
This is a more step-by-step guide that I should probably integrate with Maverick documentation at some point.
Open a Terminal

Open a terminal using the system applications menu. In the terminal type commands and press enter to run them.
Install Build Dependencies

Build dependencies for Debian/Ubuntu and Fedora based GNU/Linux distrobutions.
git is only needed if you are using the Git to download the source code instead of tar.gz archive.
Debian/Ubuntu

Terminal command:
    sudo apt install autoconf automake make gcc g++ qtbase5-dev qtbase5-dev-tools qttools5-dev-tools libgl1-mesa-dev

Fedora

Terminal command:
    sudo dnf install autoconf automake make gcc gcc-c++ qt5-qtbase-devel qt5-linguist mesa-libGLU-devel

Arch Linux

Terminal command:
    sudo pacman -S autoconf automake make gcc qt5-base qt5-tools glu```

Download Source Code

Current development version (it should be stable and fine to use):
Terminal command:
    git clone https://github.com/zturtleman/mm3d.git ~/Downloads/mm3d

~/Downloads/mm3d at the end is the directory name to write source code. It can be anywhere you want.
Alternatively you could download a tar.gz archive of latest released source code linked at https://clover.moe/mm3d.
Change to Source Code Directory

Change to the directory where the Maverick Model 3D source code is. (Whatever you put at end of git clone command.)
Terminal command:
    cd ~/Downloads/mm3d

Initial Build

Terminal commands:
    ./autogen.sh
    mkdir build
    cd build
    ../configure
    make -j2

Launching

Direct

You could run it directly using:
Terminal command (while in build directory):
    ./src/mm3d [model filename]

Terminal command (while in any directory):
    ~/Downloads/mm3d/build/src/mm3d [model filename]

This is useful if you are making changes and repeatedly building and running (make && ./src/mm3d).
Install System-wide and Add to GUI

This adds Maverick Model 3D to the GUI applications menu, copies the built files to /usr/local/, and allows running using mm3d command from CLI.
You can remove the source code afterward and Maverick will still be around and usable.
Terminal command:
    sudo make install

(Optional) Every once in a while update for new changes

Terminal commands:
    cd ~/Downloads/mm3d
    git pull
    cd build
    make -j2
    sudo make install