README.md

MOSAIC - an openFrameworks based Visual Patching Creative-Coding Platform

__

Table of Contents

• DOWNLOAD
• INSTALL
• OF_COMPATIBLE_RELEASE
• DEPENDENCIES
• DESCRIPTION
• SPECIFICATIONS
• COMPILING
• SCREENSHOTS
• LICENSE
• CREDITS

DOWNLOAD

Get Mosaic last release here: https://github.com/d3cod3/Mosaic/releases

INSTALL

LINUX

Use the automatic install script for your distro (Ubuntu/debian only for now, see COMPILING section)

MACOS

Just unzip the downloaded release and copy Mosaic app in your Application folder, that's it!

WINDOWS

Mosaic support for windows will continue at a source code level only. The code will be tested to compile correctly on windows machines, but no installers will be available for download. If you want to use Mosaic on windows, you'll need to build it yourself on your machine, just check the links below about openframeworks and qtcreator. After having openframeworks perfectly running, you'll need to clone from git all the required addons and this repository (details below for compiling).

OF COMPATIBLE RELEASE

0.10.1 STABLE (official download from OF site)

Compiled/tested with QTCreator on osx/linux/windows

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

DESCRIPTION

Mosaic is an open source multi-platform (osx, linux, windows) live coding and visual programming application, based on openFrameworks.

This project deals with the idea of integrate/amplify human-machine communication, offering a real-time flowchart based visual interface for high level creative coding. As live-coding scripting languages offer a high level coding environment, ofxVisualProgramming and the Mosaic Project as his parent layer container, aim at a high level visual-programming environment, with embedded multi scripting languages availability (Lua, GLSL, Python and BASH(macOS & linux) ).

As this project is based on openFrameworks, one of the goals is to offer as more objects as possible, using the pre-defined OF classes for trans-media manipulation (audio, text, image, video, electronics, computer vision), plus all the gigantic ofxaddons ecosystem actually available (machine learning, protocols, web, hardware interface, among a lot more).

While the described characteristics could potentially offer an extremely high complex result (OF and OFXADDONS ecosystem is really huge, and the possibility of multiple scripting languages could lead every unexperienced user to confusion), the idea behind the interface design aim at avoiding the "high complex" situation, embodying a direct and natural drag&drop connect/disconnet interface (mouse/trackpad) on the most basic level of interaction, adding text editing (keyboard) on a intermediate level of interaction (script editing), following most advanced level of interaction for experienced users (external devices communication, automated interaction, etc...)

KEYWORDS

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

DEPENDENCIES

ofxAudioAnalyzer -- Fork

ofxAudioFile

ofxBTrack -- Fork

ofxChromaKeyShader -- Fork

ofxCv

ofxDatGui -- Fork

ofxFaceTracker

ofxFFmpegRecorder -- Fork

ofxFontStash -- Fork

ofxGLEditor -- Fork

ofxHistoryPlot

ofxHttpForm

ofxJava

ofxJSON

ofxImGui -- Fork

ofxInfiniteCanvas -- Fork

ofxLua -- Fork

ofxMidi -- Fork

ofxModal -- Fork

ofxMtlMapping2D -- Fork

ofxNDI -- Fork

ofxParagraph -- Fork

ofxPd

ofxPdExternals

ofxPDSP

ofxPython -- Fork

ofxSimpleHttp

ofxThreadedFileDialog

ofxTimeline -- Fork

ofxTimeMeasurements

ofxVisualProgramming

ofxWarp -- Fork

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

SPECIFICATIONS

- cross-platform
- multi-threaded
- non-blocking system dialogs
- lua/python/glsl/bash live-coding
- pure data live-patching
- non-linear interactive timeline
- warping integrated on output window object
- mapmap style projection mapping module

COMPILING

LINUX

Here you can download (and check) a script for automatically download/clone/compile and build everything for your linux distro, and magically have Mosaic appearing on your desktop menu and perfectly working.

Ubuntu

Ubuntu Studio

Linux Mint

Debian

Fedora

MACOS

Compiling with qtcreator 4.6.1 with no issues.

WINDOWS

Compiling with qtcreator 4.6.1 with no issues.

OFXADDONS

Clone all the required addons listed:

cd <your_openframeworks_release_folder>/addons

git clone https://github.com/d3cod3/ofxAudioAnalyzer
git clone https://github.com/npisanti/ofxAudioFile
git clone https://github.com/d3cod3/ofxBTrack
git clone https://github.com/d3cod3/ofxChromaKeyShader
git clone https://github.com/kylemcdonald/ofxCv
git clone https://github.com/d3cod3/ofxDatGui
git clone https://github.com/kylemcdonald/ofxFaceTracker
git clone https://github.com/d3cod3/ofxFFmpegRecorder
git clone https://github.com/d3cod3/ofxFontStash
git clone https://github.com/d3cod3/ofxGLEditor
git clone https://github.com/armadillu/ofxGLError
git clone https://github.com/armadillu/ofxHistoryPlot
git clone https://github.com/armadillu/ofxHttpForm
git clone https://github.com/d3cod3/ofxJava
git clone https://github.com/jeffcrouse/ofxJSON
git clone https://github.com/d3cod3/ofxImGui
git clone https://github.com/d3cod3/ofxInfiniteCanvas
git clone --branch=of-0.10.0 https://github.com/d3cod3/ofxLua
git clone https://github.com/d3cod3/ofxMidi
git clone https://github.com/d3cod3/ofxModal
git clone https://github.com/d3cod3/ofxMtlMapping2D
git clone https://github.com/d3cod3/ofxNDI
git clone --branch=OF0.9.8 https://github.com/d3cod3/ofxPython
git clone https://github.com/d3cod3/ofxParagraph
git clone https://github.com/danomatika/ofxPd
git clone https://github.com/d3cod3/ofxPdExternals
git clone https://github.com/npisanti/ofxPDSP
git clone https://github.com/armadillu/ofxSimpleHttp
git clone https://github.com/d3cod3/ofxThreadedFileDialog
git clone https://github.com/d3cod3/ofxTimeline
git clone https://github.com/armadillu/ofxTimeMeasurements
git clone https://github.com/d3cod3/ofxVisualProgramming
git clone https://github.com/d3cod3/ofxWarp

Then clone Mosaic project as an openFrameworks example:

cd <your_openframeworks_release_folder>/apps/myApps

git clone --recursive https://github.com/d3cod3/Mosaic

Now you're ready to compile Mosaic! Load the .qbs project in QTCreator and compile it. Or just enter in Mosaic folder and run a make Release.

SCREENSHOTS

LICENSE

All contributions are made under the MIT License. See LICENSE.

CREDITS

Mosaic is an open source project.

The Mosaic team is composed by Emanuele Mazza and Maria José Martínez de Pisón.

Mosaic uses FFTW3, essentia, kiss_fft, libsamplerate, dr_libs, fontstash and code from openframeworks all the included ofxAddons.