Install‎ > ‎

Cinema 4D Mac Installation

autoPack: INSTALLATION for Cinema 4D (includes autoPack and ePMV in one package)


    This installation includes uPyePMV& autoPack

    This early installation for autoPack is an alpha version- use at your own risk and save frequently.
    uPy (ubiquitous Python API) enables ePMV and autoPack to work in Autodesk 3ds MaxMayaCinema 4D, SoftImageBlender and DejaVu by writing only one plugin instead of >5.
    ePMV (embedded Python Molecular Viewer) provides all of the capabilities of molecular graphics and molecular mechanics software directly in your C4D GUI.
    autoPack positions 3D geometries into, onto, and around volumes with minimal to zero overlap. autoPack mixes several packing approaches and procedural growth algorithms. autoPack can thus place objects with forces and constraints to allow a high degree of control ranging from completely random distributions to highly ordered structures.
    cellPack is a specialization of autoPack that generates probabilistic 3D models of large sections of cells that can contain dozens to trillions+ of molecules. It can position these molecules to recapitulate observed data where available and can further optimize the molecular interactions on a local level as each molecule is placed into a mesoscale model.
    If you have experience with 3D software, especially with C4D, the manual installation should take less than 3 minutes on a Mac and the one-step installer should take less than 6 minutes. 
    If you encounter difficulties, please visit the forum to search for answers or ask questions. 
    We ask that you fill out the optional survey to help us improve the installation procedure.


    1. Maxon's Cinema 4D (C4D) r12–r17
      1. If you have a different version, you can download the latest demo here to try ePMV and autoPack
    2. Uninstall any previous version of ePMV (and autoFill and autoPack)
      1. Navigate to to your C4D preferences as described in step II in the Installation of the uPy... section below 
      2. Move the ePMV folder from .../plugins to your trash (or just pull it out into the MAXON folder in case you want to revert to it later)
    3. Install X11 for Mac : X11 - XQuartz

    Installation of the uPy Plugin Package with ePMV & autoPack

    1. Open Cinema 4D
    2. Locate your Cinema4D preferences folder
      1. To ensure you have the correct preferences folder:
        1. In Cinema 4D's menu, go to Edit->Preferences
        2. Click [Open Preferences Folder] button
      2. You'll see the Preferences window now open on your desktop with a name similar to:
        1. /Users/Library/Preferences/MAXON/CINEMA 4D R16_AB12BC3E/ (the number at the end will be different and may also say R12, R14, R15, R16 or R17)
      3. Right (or control) Click on the revealed folder> Get Info: Select and Copy the path under Where: "/Users/userName/Library/Prefere..." for use below.
      4. Follow the onscreen instructions.  If you run into problems try the manual installation instead or search the forum.
    3. Install the plugin
      1. Option 1: Manual Installation of the uPy Plugin Package that includes ePMV and autoPACK
        1. Download the zipped package for your system:
          1. Cinema 4D r16 for Mac 64bits
          2. Cinema 4D r17 for Mac 64bits
          3. Cinema 4D r13–r15 for Mac
          4. Drag & drop the extracted folder into the plugins folder of your Cinema4D preferences folder (get correct folder with step 2):
          1. The extracted archive contains a folder called uPy-Mac with another folder inside called ePMV
          2. Drag both ePMV and upy_autoPack folder out of uPy-Mac and place it into your Cinema4D preference plugin folder:
          3. MAC OS /Users/userName/Library/Preferences/MAXON/CINEMA 4D R1<x>_/plugins/
      2. Option 1: One-step Installer (requires Java and is only valid for C4D R12-R15.  For R16 and R17, use manual install Option 1 above)
        1. One-step installeruPy-aP-eP_c4dR12-R15_mac_1_0_inst.jar
          1. The installer will ask you for the User preferences folder containing the plugin folder
            1. Paste in the path you copied in Step I.
          2. The installer loads software from our slow educational server and may take 5 minutes even on the fastest of internet connections.
          3. Mac C4D users may prefer the manual installation Option 2 below which downloads in < ~1 minute. Both processes install the same software.
    4. Restart Cinema 4D
    5. Launch ePMV, test it, then launch autoPACK and test it as described below
      1. You'll find the ePMV plugin under:
        1. r12: C4Dmenu: Python->Plugins
        2. r13-16: C4Dmenu: Plugins

    Complete basic tutorials for ePMV and autoPack

    1. If you are new to ePMV or new to molecular graphics, please complete the Basics Tutorial/Survey hybrid.  This will guide you through all of the common functions/buttons of the ePMV GUI and simultaneously introduces you to the science and the data types ePMV can work with.
    2. This alpha version of autoPack will improve several times each week and the tutorials will expand
      1. For now, follow the first steps and then the basic tutorials then experiment on your own.  If you find a bug, check the forum to see if its already been fixed, and if not, let us know.
        1. Cinema 4D specific tutorials for autoPACK will be posted by January 9, 2013.
        2. Find a long list of Cinema 4D specific tutorials for ePMV at
      2. Update your ePMV and autoPack software frequently to get the latest performance, stability and functionality enhancements with just a couple clicks directly from within the GUIs!
      3. You should add buttons to your startup palette:
        1. C4D menu: Window>Customize>CustomizePalettes: 
        2. In the Customize Commands window type ePMV or auto in the Filter to find the apps then drag and drop each icon where you'd like it.
        3. C4D menu: Window>Customize>SaveAsStartupLayout 

    Improve your software by volunteering to complete the surveys regularly

    1. Survey page  
      1. The Installation Survey takes less than 30 seconds and will help us improve/simplify the experience.
      2. The ePMV Basics Tutorial Survey will help you become an advanced-beginner level ePMV user and molecular artists in <40 minutes.  It will also help us improve software performance.
      3. A similarly detailed autoPack Basics Tutorial Survey will post by January 9, 2013.