Installing Framsticks on your own machine

Extensive documentation, tutorials, demos, and other information is available on the Framsticks home page.

Windows

Linux

  1. Install Homebrew by running this command in a terminal window:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    

  2. Follow the Mac instructions below starting from step 2.

Mac

  1. Install the command-line developer tools by running this command in a terminal window:

    xcode-select --install
    

  2. Install Homebrew by downloading and running the installer file:

    https://github.com/Homebrew/brew/releases/download/5.0.14/Homebrew.pkg

  3. Edit your ~/.bash_profile or ~/.zshrc file, depending on which shell you're running (you can find out by typing echo $SHELL) and add this line to the file:

    eval "$(/opt/homebrew/bin/brew shellenv)"
    
  4. Install wine by running this command in a terminal window:

    brew install --cask wine-stable
    

  5. Check if wine is working by running this command in a terminal window (it should say wine-11.0):

    wine --version
    

    If you're on a Mac and get a scary warning message saying that wine cannot be opened because it might harm your computer (it won't), go to System Settings → Privacy & Security where it says Wine was blocked to protect your Mac, and click Open Anyway. You'll have to type in your password. From now on your Mac should not be afraid of opening wine.

  6. Download and unzip the file below, which will create the folder Framsticks54. You can put this folder on your Desktop, or in your top-level home folder, or wherever you like:

    https://www.framsticks.com/files/apps/Framsticks.zip

  7. Create a new file /opt/homebrew/bin/framsticks containing the single line below, with /PATH/TO/FRAMSTICKS/FOLDER replaced by the actual path to wherever you put the Framsticks54 folder on your machine:

    /opt/homebrew/bin/wine /PATH/TO/FRAMSTICKS/FOLDER/Framsticks54/Framsticks.exe 2>/dev/null &
    

    For example, if you put the Framsticks54 folder on your Desktop, the full pathname of the executable file would be /Users/YOUR_USERNAME/Desktop/Framsticks54/Framsticks.exe

    Then run this command in a terminal window:

    chmod 755 /opt/homebrew/bin/framsticks
    

  8. To start Framsticks, just type the command framsticks in a terminal window.

    Mac users: if you are on a Mac, I have noticed that the behavior of the windows can be a bit wonky, so I would strongly suggest clicking once in each of the windows that are displayed (Groups, Artificial world, Body & Brain, Gene pool, and Populations) as soon as the program starts up, which seems to fix the issue.