Instructions for using pyschomorph using a M3 Macbook Pro, Mac OS Sonoma 14.5 (updated 7/12/24).

  1. Download the new "stand alone” Psychomorph version from here: Click here

  2. Download JDK 11: Click here if you have a Mac. Click here if you have Windows. I have no idea if later versions of Java work with this version of psychomorph.

  3. Extract this psychomorph file, by double-clicking on the file, which is ‘zipped’ to protect it. By extracting this file, you should now have a folder called something like “Psychomorph7.1” somewhere on your computer, which itself contains two subfolders, “deploylib” and “dist. Check you know where this Psychomorph folder is (find it on your computer).

  4. Open up the Terminal application (or the Console, in an older Windows).

  5. In Terminal, type “ls” and press ‘enter' to check which directory we’re in (ls stands for ‘list’; use ‘dir’ for Windows instead). What we are doing now is using a command line interface, which basically means we’re running code directly on the computer.

  6. In Terminal, type “cd P”, then press the “tab” button and then press 'enter' (tab will automatically finish the folder name for you; cd means “change directory").  The reason we change directory is that we need to point the computer at the correct folder i.e. where the Psychomorph files have been put on your computer once you extracted them. Note it needs to be a capital “P” or the exact spelling/formatting of the Psychomorph folder. 

  7. Copy and paste this line of code into the Terminal exactly:

    Mac:

     

    java -cp dist/*:deploylib/* -Xmx4000m -Dapple.laf.useScreenMenuBar=true -Djava.security.policy=applet.policy Facemorph.psychomorph.PsychoMorphForm

     

    Windows:

     

    java -cp dist/*;deploylib/* -Xmx4000m  -Djava.security.policy=applet.policy Facemorph.psychomorph.PsychoMorphForm

     

     

    Hopefully, Psychomorph now opens!

     

     

  8. Troubleshooting:

     

    i) If you get an "out of memory error" you can use a smaller value for the max heap size e.g.
    -Xmx1000m 

    This will now only ask for 1Gb of heap space, rather than the 4Gb in the commands above. Heap space is basically like working memory for the computer, some computers might have less capacity.

     

    ii) If you get an error like: "Could not find or load main class Facemorph.psychomorph.PsychoMorphForm”



    This error could occur because Terminal is not looking in the right folder i.e. it needs to find the Psychomorph folder. Check where the Psychomorph file is on your computer and make sure you have extracted the folder from the zip file. Remember that you can use “cd” in the Terminal application to keep changing the directory until you’re in the right place (e.g. Downloads or wherever your Psychomorph folder is located). A sensible place to keep Psychomorph file would be in your home directory folder or somewhere else you know you can find again.

     

    iii) You may get an error like “Unable to read config file” when Psychomorph opens. You can ignore this error.

     

    iv) You may get an error due to the type of java you are running. The code was recompiled with the latest libraries and java open jdk 11 (so you may need to upgrade your java version to run it). Java is available from here (need to scroll down a bit to find the right version):



    https://www.oracle.com/java/technologies/javase-downloads.html

     

    Make sure it is the jdk version of java.

     

    v) If you get an error that starts:

     

    Usage: java [options] <mainclass> [args...]

               (to execute a class)

       or  java [options] -jar <jarfile> [args...]

               (to execute a jar file)

       or  java [options] -m <module>[/<mainclass>] [args...]

           java [options] --module <module>[/<mainclass>] [args...]

               (to execute the main class in a module)

       or  java [options] <sourcefile> [args]

               (to execute a single source-file program)



    Then probably a character in the code you pasted in which is not conveying properly and so java can’t read the code properly. Check that you are using the right version of code for your operating system (for Windows or Mac; Windows uses semi colons; Mac uses colons) and check that you are using - (minus sign) and not — (long dash). If in doubt, paste again directly or try typing out yourself, being very careful to keep all spelling (including capital letters) exactly as shown.

Thanks to Clare Sutherland for the directions!