MOSAIC - an openFrameworks based Visual Patching Creative-Coding Platform

Mosaic

INSTALL
OF_COMPATIBLE_RELEASE
DEPENDENCIES
DESCRIPTION
SPECIFICATIONS
CONTRIBUTING
TUTORIALS
SCREENSHOTS
LICENSE
CREDITS

INSTALL

LINUX

Check the Mosaic installer here: https://github.com/d3cod3/Mosaic-Installer

Check Flathub 1 click Mosaic installer ( if installing from flathub webcam is not working ) here: https://flathub.org/apps/org.d3cod3.Mosaic

MACOS

Get Mosaic last release here: https://github.com/d3cod3/Mosaic/releases Just unzip the downloaded release and copy Mosaic app in your Application folder, that's it!

WINDOWS ( DISCONTINUED, last official release 0.6.6 )

Get Mosaic last release here: https://github.com/d3cod3/Mosaic/releases Just unzip the downloaded release and run it!

OF COMPATIBLE RELEASE

0.12.0 STABLE (official download from OF site)

Compiled/tested with QTCreator on osx/linux Compiled on native VisualStudio on Windows

If you want to build Mosaic, just download OF0.12.0 for your OS (osx, linux, windows) and follow the correspondent setup guide.

DESCRIPTION

Mosaic-Data-Flow-Diagram

~~A very commonly used quote from Albert Einstein goes like this: « If I can't picture it, I can't understand it. »~~. A very commonly used quote from Henri Bergson goes like this: « The Eyes See Only What The Mind Is Prepared To Comprehend. » Following that thought, we'll eventually enter the realm of visual thinking, or better yet, the imagination realm, where complex ideas can be communicated in a simple way, or just the opposite.

Mosaic is a visual thinking toolkit made by artists, for artists.

Emanuele Mazza started the Mosaic project in 2018, in strict relation with the work of ART+TECHNOLOGY research group Laboluz from the Fine Art faculty of the Universidad Politécnica de Valéncia (Spain). From the very beginning, the source code was released on the Github development platform with a focus on making the code modular and simple to read, in order to encourage potentially interested coders in participating and collaborating on the project. Recently in 2020, digital artist Daan de Lange became a contributor of Mosaic code, participating in code development and restructuring.

Mosaic is a multi-platform livecoding programming/patching environment for creating real-time audio-visual compositions. It's principally designed for live needs, as can be teaching in class, live performing in an algorave, or running a generative audio-visual installation in a museum. It aims to empower artists, creative coders, scenographers and other creative technologists in their creative workflow. It's a FLOSS, Free/Libre and Open Source Software with multi-platform support, and it's written in C++, offering high performance.

Mosaic is shipped with an internal code editor, non-blocking system dialogs, a programmable non-linear interactive timeline, lua/glsl/bash live-coding and pure data live-patching capability, a good selection of audio synthesis modules, multiple fullscreen output windows capabilities ( as many as your system can have ) with an independent warping for each window, a map-map style integrated mapping module, arduino communication made easy, midi capabilities and an easy to use osc sending/receiving objects/nodes for network communication.

The idea behind Mosaic is to facilitate human-machine communication, to amplify imagination and to speed up the creative workflow, without sacrificing the spectrum of possibilities. To achieve this, it bundles together various creative-coding tools, acting as an interactive bridge between them. It includes a collection of audio-visual objects that can be easily connected together using a nodal-based graphical interface, defining a custom dataflow.

Mosaic is mainly based on two frameworks : OpenFrameworks and ImGui. OpenFrameworks is an open source C++ toolkit for creative coding. Dear ImGui is a bloat-free graphical user interface for C++ with minimal dependencies. Together with the latter ones, Mosaic bundles comes with other 3rd party libraries such as libpd and numerous ofxAddons. It also embeds various programming languages for live-coding purposes : Lua with OF-bindings scripting interpreter, live compiling of GLSL shaders and editing/execute Bash scripts (macOS & linux) capabilities.

Mosaic is extendable : you can easily add custom objects. While this involves writing and compiling code, requiring some C++ knowledge, we aim to make this process as easy as possible. Thus, Mosaic is flexible and devoted to grow over time. For example, any Openframeworks project can be easily ported to Mosaic Objects, exposing them to the live-patching environment. This way, working with OF becomes way more modular, and you can make run-time adjustments. Possibilities are endless. Once created, plugins can either be statically compiled into Mosaic, or if you wish, there's also support for dynamically loading them, making it easy to share and distribute your objects with others.

KEYWORDS

Mosaic, ofxVisualProgramming, openframeworks, linux, macOS, windows, creative-coding, live-coding, physical, visual, scripting, transmedia, programming, visual-programming

DEPENDENCIES

ofxAudioFile -- FOrk

ofxBTrack -- Fork

ofxCv

ofxEasing

ofxFFmpegRecorder -- Fork

ofxGLEditor

ofxImGui -- Fork

ofxInfiniteCanvas -- Fork

ofxLua

ofxMidi

ofxMtlMapping2D -- Fork

ofxNDI -- Fork

ofxOpenDHT

ofxPd

ofxPDSP -- Fork

ofxScheme

ofxSyphon -- Fork

ofxTimeline -- Fork

ofxVisualProgramming

ofxWarp -- Fork

Some addons are forks of the original, due to some mods, compatibility with OF0.11 and the intention of cross-platform compiling (osx,linux,win)

SPECIFICATIONS

FLOSS, Free/Libre and Open Source Software
cross-platform (Linux, macOS, Windows)
plugin injection capable, see ofxMosaicPlugin
multi-threaded
ImGui based GUI interface
non-blocking system dialogs
internal code editor
lua/glsl/bash live-coding
pure data live-patching
non-linear interactive timeline
good selection of audio synthesis modules
warping integrated on output window object
mapmap style projection mapping module
internal dht distributed chatroom, based on libdht

OFXADDONS

Clone all the required addons listed:

cd <your_openframeworks_release_folder>/addons

git clone https://github.com/d3cod3/ofxAudioFile
git clone https://github.com/d3cod3/ofxBTrack
git clone https://github.com/kylemcdonald/ofxCv
git clone https://github.com/arturoc/ofxEasing
git clone https://github.com/d3cod3/ofxFFmpegRecorder
git clone https://github.com/Akira-Hayasaka/ofxGLEditor
git clone https://github.com/d3cod3/ofxImGui
git clone https://github.com/d3cod3/ofxInfiniteCanvas
git clone https://github.com/danomatika/ofxLua
git clone https://github.com/danomatika/ofxMidi
git clone https://github.com/d3cod3/ofxMtlMapping2D
git clone --branch=NDI5 https://github.com/d3cod3/ofxNDI
git clone https://github.com/d3cod3/ofxOpenDHT
git clone https://github.com/danomatika/ofxPd
git clone https://github.com/d3cod3/ofxPDSP
git clone https://github.com/d3cod3/ofxScheme
git clone https://github.com/d3cod3/ofxSyphon
git clone https://github.com/d3cod3/ofxTimeline
git clone https://github.com/d3cod3/ofxVisualProgramming
git clone https://github.com/d3cod3/ofxWarp

Some addons use specific branches and remotes (usually in order to provide easy multiplatform support). Specially if you have already worked with OpenFrameworks, your current addons folder might be incompatible with Mosaic. To verify compatibility, it can be useful to cd path/to/mosaic && cd scripts/ofxAddonTool && ./ofxAddonTool.sh to get an oversight of ofxAddons compatibility.

Then clone Mosaic project as an openFrameworks example:

cd <your_openfr