Umfeld is an environment for audio- and graphics-based applications. Umfeld is a C++ variant of Processing.org.

Quickstart

1. Prepare

• on macOS: no preparation needed
• on Linux: open a console and run sudo apt install -y git curl
• on Windows ( MSYS2 UCRT64 ): install MSYS2 and open the MSYS2 UCRT64 console

2. Install Dependencies + Download Umfeld

open a console, navigate to the desired installation folder, and run the following script:

/bin/bash -c "$(curl -fsSL https://codeberg.org/Umfeld/umfeld/raw/branch/main/install.sh)" _ --latest

this script downloads the latest release of Umfeld with examples and external libraries, into the current directory. it also installs all required packages on macOS, Linux ( including Raspberry Pi OS ), and Windows ( MSYS2 UCRT64 ).

⚠️ IMPORTANT ⚠️ on Windows ( MSYS2 UCRT64 ), the console might close when running the script above. this is expected behavior ( part of the self-updating process ). just run the script again. it should work fine the second time.

3. Run an Umfeld Application

run an application created from a template. open a console, navigate to an empty folder, and run this script:

curl -sSL -o umfeld.command https://d3-is.de/umfeld-app &&
  chmod +x umfeld.command && 
  ./umfeld.command

the command above downloads and executes a script from https://d3-is.de/umfeld-app. the script handles configuring, building, and running and Umfeld application.

alternatively, you can run an example ( e.g. minimal ). open a console, navigate to the example folder and run the CMake build commands:

cd umfeld-examples/Basics/minimal
cmake -B build
cmake --build build
./build/minimal

if everything works, head over to the Umfeld repository or join the conversation.