Getting Started

The end goal is to have Soup running on all three major operating systems, and building for any target. However, because I do not have access to a Mac device we only support Linux and Windows today.

Requirements

Linux

Ubuntu 24.04
Build Tools
- sudo apt install build-essential

Windows

Windows 11
Build Tools
- Visual Studio 2022 with "Desktop development with c++" workload.
- OR
- Build Tools For Visual Studio 2022 with "c++ build tools" workload.

Setup

You can either install Soup or download a reference the archive.

Linux

Debian Package (recommended)

wget https://github.com/soup-build/soup/releases/latest/download/soup-build-amd64.deb
sudo apt install ./soup-build-amd64.deb
rm soup-build-amd64.deb

Archive

Download the soup-build-linux-x64.tar.gz archive from the Latest Release.

Decompress the Soup release somewhere safe and add it to your path in a command prompt.
```
export PATH=$PATH;~/soup/bin/
```

Windows

Winget (recommended)
```
winget install SoupBuild.Soup
```
Installer

Download and run the SoupBuild.msi installer from the Latest Release.

Note: The installer is signed signature may not be trusted yet and you will have to ignore some scary warnings. When Microsoft receives enough trusted notifications this will no longer be necessary.
Archive

Download the soup-build-windows-x64.zip archive from the Latest Release.

Unzip the Soup release somewhere safe and add it to your path in a command prompt.
```
set PATH=%PATH%;C:\Soup\bin\
```
Or add it to the "Path" System Environment Variable to always have it available!