Make sure the following dependencies are installed:

• cmake
• SDL2
• openal
• libvorbis
• libpng

mkdir build
(cd build && cmake .. make)
./freegish

mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -DINSTALL_FHS=ON
make
make install

To develop on Windows the following tools need to be installed:

• CMake
• Visual Studio 2022
• vcpkg

Below is described how to install and set them up.

CMake is used for building Freegish and can be downloaded from here. Make sure to use the installer and select "Add CMake to system PATH" during installation.

Installing Visual Studio installs the IDE, compiler and some other tools required to build Freegish. Get the community version installer from here and install the workload "Desktop development with C++" with it.

vcpkg is a package manager for C and C++ which allows the libraries used to be installed. Installation instructions can be found [https://vcpkg.io/en/getting-started.html]. This README assumes that vcpkg is installed in C:\vcpkg.

Then install the required package with the following command:

C:\vcpkg\vcpkg.exe install --triplet x64-windows openal-soft libogg libvorbis libpng sdl2 opengl

To build the game open powershell in the directory in which Freegish is cloned then simply issue:

mkdir build
cd build
cmake -DCMAKE_TOOLCHAIN_FILE=C:\vcpkg\scripts\buildsystems\vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-windows ..
cmake --build . --config Release

After that copy the content of the Release directory to the freegish directory. To start the game run freegish.exe

To get Freegish developing going in Visual Studio, a project file needs to be generated. This can be done with the following commands in a terminal opened in the directory in which Freegish is cloned:

 cmake -DCMAKE_TOOLCHAIN_FILE=E:\vcpkg\scripts\buildsystems\vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-windows -G "Visual Studio 17 2022" .

Then open FreeGish.sln with Visual Studio.

Before being able to run from Visual Studio, the debug configuration has to be set. To do this, press the small arror down next to the run button with "Local Windows Debugger" next to it on the screen, then pick "All_BUILD Debug Properties". Set "Output Directory" to $(SolutionDir) and "Target Name" to Debug/freegish.exe like in this image:

Now you just just start debugging like normal by pressing the run button or F5.

Install development packages via homebrew:

brew install cmake sdl2 libvorbis openal-soft libpng

Configure the project using CMake, and compile + run with your compiler/IDE of choice.

Simply run ./gish or gish.exe. There are some assets included (codenamed the FreeGish project), making Gish a completely free game!

If you own the original assets, you may also copy those into this directory. You'll need:

• animation
• level
• music
• sound
• texture
• tile01 ... tile07

Afterwards run rename-levels.sh DIRECTORY_WITH_ASSETS script to rename files so that they match Freegish naming convention (see #2 (comment)).