{"id":23803524,"url":"https://github.com/d3cod3/mosaic","last_synced_at":"2025-05-16T01:05:50.027Z","repository":{"id":39746142,"uuid":"134846180","full_name":"d3cod3/Mosaic","owner":"d3cod3","description":"Mosaic, an openFrameworks based Visual Patching Creative-Coding Platform","archived":false,"fork":false,"pushed_at":"2025-05-01T16:18:54.000Z","size":226907,"stargazers_count":454,"open_issues_count":9,"forks_count":23,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-05-01T16:44:32.691Z","etag":null,"topics":["audio","creative-coding","graphics","linux","live-coding","mosaic","openframeworks","osx","transmedia","video","visual-programming","windows"],"latest_commit_sha":null,"homepage":"https://mosaic.d3cod3.org","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/d3cod3.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"d3cod3","patreon":null,"open_collective":null,"ko_fi":"d3cod3","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2018-05-25T11:14:53.000Z","updated_at":"2025-04-29T11:51:37.000Z","dependencies_parsed_at":"2023-02-14T00:46:12.365Z","dependency_job_id":"9479e403-c67f-4684-a9a0-3fe5357a387b","html_url":"https://github.com/d3cod3/Mosaic","commit_stats":{"total_commits":614,"total_committers":3,"mean_commits":"204.66666666666666","dds":0.01791530944625408,"last_synced_commit":"77650268d14c7a1f802c989d5da4091308755171"},"previous_names":[],"tags_count":42,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d3cod3%2FMosaic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d3cod3%2FMosaic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d3cod3%2FMosaic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d3cod3%2FMosaic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/d3cod3","download_url":"https://codeload.github.com/d3cod3/Mosaic/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254448579,"owners_count":22072764,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","creative-coding","graphics","linux","live-coding","mosaic","openframeworks","osx","transmedia","video","visual-programming","windows"],"created_at":"2025-01-01T22:32:13.098Z","updated_at":"2025-05-16T01:05:45.011Z","avatar_url":"https://github.com/d3cod3.png","language":"C++","readme":"![Mosaic logo](https://github.com/d3cod3/Mosaic/raw/master/process/logo/logo_150.png)\n\n# [MOSAIC](https://mosaic.d3cod3.org) - an openFrameworks based Visual Patching Creative-Coding Platform\n\n![Mosaic](https://github.com/d3cod3/Mosaic/raw/master/process/img/31_sintax03.jpg)\n\n[![Mosaic Forum](https://img.shields.io/badge/forum-Mosaic%20Forum-2000ff)](https://mosaicforum.cryptoriot.art/)\n\n[![Discord Mosaic Visual Programming](https://img.shields.io/badge/discord-Mosaic%20Visual%20Programming-2000ff)](https://discord.com/invite/sPJr6EEpyG)\n\n[![Youtube @d3cod3Channel](https://img.shields.io/badge/Youtube-d3cod3_Channel-2000ff)](https://www.youtube.com/@d3cod3Channel)\n\n__\n\nTable of Contents\n=================\n\n   * [INSTALL](#install)\n   * [OF_COMPATIBLE_RELEASE](#of_compatible_release)\n   * [DEPENDENCIES](#dependencies)\n   * [DESCRIPTION](#description)\n   * [SPECIFICATIONS](#specifications)\n   * [CONTRIBUTING](#contributing)\n   * [TUTORIALS](#tutorials)\n   * [SCREENSHOTS](#screenshots)\n   * [LICENSE](#license)\n   * [CREDITS](#credits)\n\n\n# INSTALL\n\n## LINUX\n\nCheck the Mosaic installer here: https://github.com/d3cod3/Mosaic-Installer\n\nor\n\nCheck Flathub 1 click Mosaic installer ( if installing from flathub webcam is not working ) here: https://flathub.org/apps/org.d3cod3.Mosaic\n\n## MACOS\n\nGet Mosaic last release here: https://github.com/d3cod3/Mosaic/releases\nJust unzip the downloaded release and copy Mosaic app in your Application folder, that's it!\n\n## WINDOWS ( DISCONTINUED, last official release [0.6.6](https://github.com/d3cod3/Mosaic/releases/tag/0.6.6) )\n\nGet Mosaic last release here: https://github.com/d3cod3/Mosaic/releases\nJust unzip the downloaded release and run it!\n\n\n# OF COMPATIBLE RELEASE\n\n## 0.12.0 STABLE (official download from [OF site](https://openframeworks.cc/))\n\u003e Compiled/tested with QTCreator on osx/linux\n\u003e Compiled on native VisualStudio on Windows\n\nIf you want to build Mosaic, just download OF0.12.0 for your OS (osx, linux, windows) and follow the correspondent setup guide.\n\n# DESCRIPTION\n\n![Mosaic-Data-Flow-Diagram](https://github.com/d3cod3/Mosaic/raw/master/process/img/10_Mosaic-Data-Flow-Diagram.jpg)\n\n~~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.\n\nMosaic is a visual thinking toolkit made by artists, for artists.\n\n[Emanuele Mazza](https://github.com/d3cod3) 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](https://github.com/Daandelange) became a contributor of Mosaic code, participating in code development and restructuring.\n\nMosaic 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.\nIt aims to empower artists, creative coders, scenographers and other creative technologists in their creative workflow.\nIt's a FLOSS, Free/Libre and Open Source Software with multi-platform support, and it's written in C++, offering high performance.\n\nMosaic 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.\n\nThe 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.\nIt includes a collection of audio-visual objects that can be easily connected together using a nodal-based graphical interface, defining a custom dataflow.\n\nMosaic is mainly based on two frameworks : OpenFrameworks and ImGui. OpenFrameworks is an open source C++ toolkit for creative coding.\nDear ImGui is a bloat-free graphical user interface for C++ with minimal dependencies.\nTogether with the latter ones, Mosaic bundles comes with other 3rd party libraries such as [libpd](https://github.com/libpd/libpd) and numerous ofxAddons.\nIt 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 \u0026 linux) capabilities.\n\nMosaic is extendable : you can easily [add custom objects](https://github.com/d3cod3/ofxMosaicPlugin).\nWhile 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.\nFor 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.\nOnce 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.\n\n\n#### KEYWORDS\nMosaic, ofxVisualProgramming, openframeworks, linux, macOS, windows, creative-coding, live-coding, physical, visual, scripting, transmedia, programming, visual-programming\n\n# DEPENDENCIES\n\n\n#### [ofxAudioFile](https://github.com/d3cod3/ofxAudioFile) -- FOrk\n\n#### [ofxBTrack](https://github.com/d3cod3/ofxBTrack) -- Fork\n\n#### [ofxCv](https://github.com/kylemcdonald/ofxCv)\n\n#### [ofxEasing](https://github.com/arturoc/ofxEasing)\n\n#### [ofxFFmpegRecorder](https://github.com/d3cod3/ofxFFmpegRecorder) -- Fork\n\n#### [ofxFft](https://github.com/kylemcdonald/ofxFft)\n\n#### [ofxGLEditor](https://github.com/Akira-Hayasaka/ofxGLEditor)\n\n#### [ofxImGui](https://github.com/d3cod3/ofxImGui) -- Fork\n\n#### [ofxInfiniteCanvas](https://github.com/d3cod3/ofxInfiniteCanvas) -- Fork\n\n#### [ofxLua](https://github.com/danomatika/ofxLua)\n\n#### [ofxMidi](https://github.com/danomatika/ofxMidi)\n\n#### [ofxMtlMapping2D](https://github.com/d3cod3/ofxMtlMapping2D) -- Fork\n\n#### [ofxNDI](https://github.com/d3cod3/ofxNDI) -- Fork\n\n#### [ofxOpenDHT](https://github.com/d3cod3/ofxOpenDHT)\n\n#### [ofxPd](https://github.com/danomatika/ofxPd)\n\n#### [ofxPDSP](https://github.com/d3cod3/ofxPDSP) -- Fork\n\n#### [ofxScheme](https://github.com/d3cod3/ofxScheme)\n\n#### [ofxSyphon](https://github.com/d3cod3/ofxSyphon) -- Fork\n\n#### [ofxTimeline](https://github.com/d3cod3/ofxTimeline) -- Fork\n\n#### [ofxVisualProgramming](https://github.com/d3cod3/ofxVisualProgramming)\n\n#### [ofxWarp](https://github.com/d3cod3/ofxWarp) -- Fork\n\nSome addons are forks of the original, due to some mods, compatibility with OF0.11 and the intention of cross-platform compiling (osx,linux,win)\n\n\n# SPECIFICATIONS\n\n  - [FLOSS](https://www.gnu.org/philosophy/floss-and-foss.en.html), Free/Libre and Open Source Software\n  - cross-platform (Linux, macOS, Windows)\n  - plugin injection capable, see [ofxMosaicPlugin](https://github.com/d3cod3/ofxMosaicPlugin)\n  - multi-threaded\n  - ImGui based GUI interface\n  - non-blocking system dialogs\n  - internal code editor\n  - lua/glsl/bash live-coding\n  - pure data live-patching\n  - non-linear interactive timeline\n  - good selection of audio synthesis modules\n  - warping integrated on output window object\n  - mapmap style projection mapping module\n  - internal dht distributed chatroom, based on libdht\n\n\n# OFXADDONS\n\nClone all the required addons listed:\n\n```bash\ncd \u003cyour_openframeworks_release_folder\u003e/addons\n\ngit clone https://github.com/d3cod3/ofxAudioFile\ngit clone https://github.com/d3cod3/ofxBTrack\ngit clone https://github.com/kylemcdonald/ofxCv\ngit clone https://github.com/arturoc/ofxEasing\ngit clone https://github.com/d3cod3/ofxFFmpegRecorder\ngit clone https://github.com/kylemcdonald/ofxFft\ngit clone https://github.com/Akira-Hayasaka/ofxGLEditor\ngit clone https://github.com/d3cod3/ofxImGui\ngit clone https://github.com/d3cod3/ofxInfiniteCanvas\ngit clone https://github.com/danomatika/ofxLua\ngit clone https://github.com/danomatika/ofxMidi\ngit clone https://github.com/d3cod3/ofxMtlMapping2D\ngit clone --branch=NDI5 https://github.com/d3cod3/ofxNDI\ngit clone https://github.com/d3cod3/ofxOpenDHT\ngit clone https://github.com/danomatika/ofxPd\ngit clone https://github.com/d3cod3/ofxPDSP\ngit clone https://github.com/d3cod3/ofxScheme\ngit clone https://github.com/d3cod3/ofxSyphon\ngit clone https://github.com/d3cod3/ofxTimeline\ngit clone https://github.com/d3cod3/ofxVisualProgramming\ngit clone https://github.com/d3cod3/ofxWarp\n\n```\n\nSome 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 \u0026\u0026 cd scripts/ofxAddonTool \u0026\u0026 ./ofxAddonTool.sh` to get an oversight of ofxAddons compatibility.\n\nThen clone Mosaic project as an openFrameworks example:\n\n```bash\ncd \u003cyour_openframeworks_release_folder\u003e/apps/myApps\n\ngit clone --recursive https://github.com/d3cod3/Mosaic\n```\n\nNow 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.\n\n# CONTRIBUTING\n\nContributing to the project adding new objects is relatively easy, as ofxVisualProgramming is at the core of [Mosaic](https://github.com/d3cod3/Mosaic) software, it has been implemented a plugin mechanism based on [Pugg](http://pugg.sourceforge.net/), in order to facilitate the extension and the creation of new objects/nodes to add at the ofxVisualProgramming/Mosaic default objects/nodes library. (see objects/nodes list below)\n\nYou can find the repo of the plugin template here: [ofxMosaicPlugin](https://github.com/d3cod3/ofxMosaicPlugin), with some generic objects templates and more detailed info in the readme.\n\nIf you're curious, please try out Mosaic and don't hesitate to get in touch.\nMosaic is open to anybody, contributions of any kind are welcome.\n\n# TUTORIALS\n\nCheck the [@d3cod3Channel](https://www.youtube.com/@d3cod3Channel) on youtube\n\n[![Watch the video](https://img.youtube.com/vi/_hn5jUJpou4/maxresdefault.jpg)](https://www.youtube.com/watch?v=_hn5jUJpou4\u0026list=PLCCudLYpJ19rKU1-FAisswdLhBM4t9snf)\n\n# SCREENSHOTS\n\n![Mosaic 0.6.4_beta](https://github.com/d3cod3/Mosaic/raw/master/process/img/30_mosaicWireless.jpg)\n\n![Mosaic 0.4.3_beta](https://github.com/d3cod3/Mosaic/raw/master/process/img/29_1979.jpg)\n\n![Mosaic 0.4.0_beta](https://github.com/d3cod3/Mosaic/raw/master/process/img/25_transparent_machines.jpg)\n\n![Mosaic pre_0.2.0](https://github.com/d3cod3/Mosaic/raw/master/process/img/23_helloSonogram.jpg)\n\n![Mosaic pre_0.2.0](https://github.com/d3cod3/Mosaic/raw/master/process/img/22_Ry_ofLoffler.jpg)\n\n![Mosaic 0.1.7](https://github.com/d3cod3/Mosaic/raw/master/process/img/21_mappingBebop.jpg)\n\n![Mosaic 0.1.7](https://github.com/d3cod3/Mosaic/raw/master/process/img/20_jupiterBlues.jpg)\n\n![Mosaic pre_0.1.7](https://github.com/d3cod3/Mosaic/raw/master/process/img/19_rememberPD.jpg)\n\n![Mosaic pre_0.1.6](https://github.com/d3cod3/Mosaic/raw/master/process/img/18_pre0.1.6.jpg)\n\n![Mosaic pre_alpha_0.1.0](https://github.com/d3cod3/Mosaic/raw/master/process/img/09_we_are_near_alpha_station.png)\n\n![Mosaic pre_alpha_0.1.0](https://github.com/d3cod3/Mosaic/raw/master/process/img/08_life_is_full_of_possibilities.png)\n\n![Mosaic on linux](https://github.com/d3cod3/Mosaic/raw/master/process/img/03_Mosaic_linux_cinnamon_screenshot.png)\n\n![Mosaic on windows](https://github.com/d3cod3/Mosaic/raw/master/process/img/04_Mosaic_windows_screenshot.png)\n\n# LICENSE\n\n[![license](https://img.shields.io/github/license/mashape/apistatus.svg)](LICENSE)\n\nAll contributions are made under the [MIT License](https://opensource.org/licenses/MIT). See [LICENSE](https://github.com/d3cod3/Mosaic/blob/master/LICENSE.md).\n\n# CREDITS\n\nMosaic is a [FLOSS](https://www.gnu.org/philosophy/floss-and-foss.en.html), Free/Libre and Open Source Software.\n\nMosaic is almost completely based on [ofxVisualProgramming](https://github.com/d3cod3/ofxVisualProgramming) ofxaddon, if you like this software and are giving it a star, please consider giving another one at [ofxVisualProgramming](https://github.com/d3cod3/ofxVisualProgramming) repo.\n\nThe Mosaic team is composed by [Emanuele Mazza](https://github.com/d3cod3) [\u003cimg src=\"https://avatars0.githubusercontent.com/u/141075?v=4\" height=50 width=50\u003e](https://github.com/d3cod3), [Daan de Lange](https://github.com/Daandelange) [\u003cimg src=\"https://avatars0.githubusercontent.com/u/1329784?v=4\" height=50 width=50\u003e](https://github.com/Daandelange) and Maria José Martínez de Pisón.\n\nMosaic uses [ImGui](https://github.com/ocornut/imgui), [kiss_fft](https://github.com/mborgerding/kissfft), [libsamplerate](https://github.com/erikd/libsamplerate), [ffmpeg](https://github.com/FFmpeg/FFmpeg), [opendht](https://github.com/savoirfairelinux/opendht)  and code from openframeworks and all the included ofxAddons.\n","funding_links":["https://github.com/sponsors/d3cod3","https://ko-fi.com/d3cod3"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd3cod3%2Fmosaic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fd3cod3%2Fmosaic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd3cod3%2Fmosaic/lists"}