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

Quickstart

Umfeld Processing Mode

the easiest way to get started is by installing the Umfeld Processing Mode from within the Processing IDE via the Contribution Manager. run examples from Processing > File > Examples...

Umfeld via CLI

it is also rather easy to use Umfeld from the Command Line Interface (CLI). open a console and make sure curl is installed. navigate to desired installation folder and run this installer script:

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

run minimal example with helper script ( configure, compile + run ):

cd umfeld-examples/Basics/minimal && 
  curl -sSL -o umfeld.command https://d3-is.de/umfeld-app && 
  chmod +x umfeld.command && 
  ./umfeld.command --run

Manual Installation

1. Prepare

  • macOS: no preparation needed
  • Raspberry Pi OS: no preparation needed
  • Linux: open console, install curl with system package manager
  • Windows ( MSYS2 UCRT64 ): install MSYS2, open MSYS2 UCRT64, run pacman -S --noconfirm --needed ucrt64/mingw-w64-ucrt-x86_64-curl

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 commands above download and executes a script from https://d3-is.de/umfeld-app. the script handles configuring, building, and running an 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

Next Steps

Umfeld is funded by Hochschule für Künste Bremen