How to compile (Linux)

Make sure the following dependencies are installed:

• cmake
• SDL2
• openal
• libvorbis
• libpng

Build for development

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

Install

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

How to compile (Windows with MSVC/VS)

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

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.

Visual Studio 2022

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

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

Compiling

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

Using Visual Studio

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.

How to compile (macOS)

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.

How to play

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)).