CLOUDS Interactive Documentary
HTML C++ Max Shell GLSL Objective-C++ Other
Latest commit 390f58e Jul 10, 2016 James George finished mac builds
Failed to load latest commit information.
CLOUDS project update Jul 9, 2016
CloudsData fixing HUD scales Jul 9, 2016
CloudsHUDDesigner tunnel for print added Apr 24, 2016
CloudsLibrary/src project update Jul 9, 2016
CloudsLinker tunnel for print added Apr 24, 2016
CloudsPresetColorConverter RGB -> HSV Dec 12, 2013
CloudsQuestionNode quick fix for os x Mar 6, 2015
CloudsRGBDExporter changes before screen captures Mar 30, 2015
CloudsSVGer svg exporter Apr 8, 2014
CloudsSecondaryDisplay saved changes from doing screen captures Apr 21, 2015
CloudsStoryEngine Merge branch 'master' of… Mar 17, 2015
CloudsSubtitleTest finding translated topics Feb 26, 2015
CloudsVHXFlow compressed SVGs, reduce image sizes May 30, 2015
CloudsVisualSystemTester fixed rgbd video Apr 9, 2016
GPUParticleTests using Jul 24, 2014
OculusDirectTest Oculus updates Jul 3, 2016
RTCMIX_proof_of_concept1 Merge branch 'master' of into feature-64 Jun 9, 2014
SVGCleaner compressed SVGs, reduce image sizes May 30, 2015
ShaderBackgroundTest crazy ball thing, ready to move into RGBDVS Apr 10, 2014
ShaderLineExample working on adding the animation shader… Jan 4, 2014
VS2DVideo getting 2D Video working through VHX May 22, 2015
VS3DModelLoader 3D model loader fix May 26, 2014
VSAutomata prep for yebizo screening Feb 28, 2015
VSBalloons added final missing visual systems May 30, 2015
VSCandyMountains VS Candy Mt Jun 11, 2014
VSChromogram commit Dec 15, 2013
VSCirclePacking Set prompt for interaction for CirclePacking, ExampleBox2D, ExampleVe… Jun 30, 2014
VSCircuit Circuit: Added standalone. May 20, 2014
VSClusterMap various rift fixes Jul 9, 2016
VSCode fixing project files Jan 7, 2014
VSColony Fixed VSColony standalone. May 14, 2015
VSConnectors project files Jun 9, 2014
VSCubeCraft Merge branch 'feature-64' of into featur… May 27, 2014
VSDataCascade 64 bit mac os x build working!!! Jun 8, 2014
VSEmpty add VSBalloons(WIP) Apr 16, 2014
VSExampleBox2D using ofSoundPlayer istead of Tonic in Box2D Jan 9, 2014
VSExampleMPMFluid Merge branch 'master' of into feature-64 Jun 9, 2014
VSExampleOpenSteer ExampleOpenSteer: Fixed project again. Jun 11, 2014
VSFireworks Fixed Fireworks and added solution. Apr 7, 2014
VSFlocking world and flocking 64 bit projects Jun 28, 2014
VSFlying flying fixes Apr 17, 2016
VSGPUParticles VS GPU Particles Nov 20, 2013
VSGesturePaint Interactivity prompt for mouse version Jun 30, 2014
VSHistogram Updated Histogram system and standalone. May 27, 2015
VSLSystem Lsystem stand alone Jun 30, 2014
VSLaplacian fixed laplacian tunnel Jun 27, 2015
VSMandala fixing unitialized vars for lars Jun 27, 2014
VSMandalaComponents Mandala: prudenced it a bit Dec 20, 2013
VSMarchingCubes updated marching cubes shaders Jan 10, 2014
VSMazeGenerator2 fixed MazeGenerator2 naming Jan 10, 2014
VSMemory stand alones and fixes May 27, 2014
VSNbody start to new n-body particles, not yet working Dec 2, 2013
VSNeurons project files Jun 9, 2014
VSOcean Updated Ocean solution. Apr 4, 2014
VSOpenP53DIntro updated project file for 10.7 Oct 25, 2013
VSOpenP5Caustics OpenP5Caustics: First version! Nov 13, 2013
VSOpenP5Fifteen Capped VS standalone framerate to 60fps. Nov 21, 2013
VSOpenP5Machine OpenP5Machine: added sound Dec 28, 2013
VSOpenP5Sixteen mild tweaking Nov 7, 2013
VSOpenP5SpinningSolids Oculus VR compatibility Nov 11, 2013
VSOpenP5TextUniverse crazier merge May 6, 2014
VSOrbit Orbit: optimisation WIP Jan 4, 2014
VSPages crazier merge May 6, 2014
VSPaintBrush Input: Updated Kinect call in YellowTail and PaintBrush. Dec 11, 2013
VSParadox VSParadox Apr 17, 2014
VSPhotoGlitch Created solutions and fixed: LIA, OpenP5Spaghetti, OpenP5TextUniverse… Apr 5, 2014
VSPointCloudPeople hud rendering new way Apr 23, 2016
VSProcess11 crazier merge May 6, 2014
VSRGBDvideo fixed rgbd video Apr 9, 2016
VSRandomDigits2 Presets Jan 8, 2014
VSReplicator updated VSReplicator standalone app Jan 10, 2014
VSRipples temp defined out tonic textures for file size Mar 13, 2015
VSRulez Flying: new tree Dec 15, 2013
VSSchlabberbox disabled crashy schlabberbox Jun 29, 2014
VSScrape Removed unused ScrapeCamera. Nov 7, 2013
VSSwim updating installers Apr 24, 2016
VSThingsInTheDark gap for cadence, update clipStartTime Oct 15, 2013
VSTunnelDrawing tunnel drawing fix Apr 9, 2016
VSTwitter person selection working in Twitter map May 9, 2015
VSUextrude VS Uextrude Dec 7, 2013
VSVectorFlow adding main gain control to various visual systems: MPMFluid, Memory,… Jan 10, 2014
VSVerletForm Updated VerletForm. Mar 31, 2014
VSVision 64 bit mac os x build working!!! Jun 8, 2014
VSVisuals getting the visuals going in the flow May 3, 2015
VSVoro voro vs files and added rift rendering settings May 28, 2014
VSWebHistory WebHistory: Updated testApp. Dec 10, 2013
VSWorld world and flocking 64 bit projects Jun 28, 2014
VSWormHole fixing stuff for IDFA Nov 2, 2014
VSYellowTail using Jul 24, 2014
icon_design icon stuff Mar 11, 2015
instructions finished mac builds Jul 10, 2016
libStoryEngine fixing project files, restructure Feb 19, 2015
libVisualSystemLibrary Oculus settings Feb 19, 2015
release git ignore set up for new build process May 30, 2015
scripts finished mac builds Jul 10, 2016
source_illsutrator view source & contact May 30, 2015
testRTcmix_2013_07_28 Keywords etc Aug 27, 2013
zz_CloudsColourSelector clean up Dec 26, 2013
zz_Launchers instruction pngs Sep 2, 2014
zz_RTCMIX_proof_of_concept1 fixed project file Feb 25, 2015
.gitignore ignoring crypto back up Jun 18, 2015
KinectOSC.props Actually saved something in the Kinect OSC props sheet. Apr 11, 2014
OculusRift.props Added prop sheets for setting Kinect and Rift preprocessor defines. Apr 7, 2014 updated readme for build instructions Mar 21, 2015 Replaced ofxAvailability by ofxReachability. Jul 2, 2015 updated push_presets.ssh Sep 9, 2013 3dmodel loader rename, update scripts Dec 7, 2013


June 12 2014

We're opening up the CLOUDS repo as the beginning of a conversation, as a learning tool. We've all learned a lot from working on this project and had a blast doing it, and we feel like sharing the work is the next step. We hope you enjoy it and find it useful, and would love to hear what you do with it.

Not everything is going to work out of the box, but we'll be adding components and how-tos as we move forward. If you have any questions or problems, open an issue and we'll be happy to help.

Set Up

  1. Download the CLOUDS branch of openFrameworks from here.
  2. Clone CLOUDS into the OF/apps directory.
  3. Run the script to pull all required addons in the appropriate location. Run the following commands in your Terminal:

    cd OF/apps/CLOUDS
  4. While we fix a few things with the open source version, you'll also need to follow the few extra fixes listed here:


  • A Visual System is a code module that can be configured to present dynamic generative and interactive graphics. The Visual Systems are artworks and algorithmic examples contributed by artists featured in the documentary, as well as collaborators on the project.
    • Some Visual Systems are original commissioned works by artists represented in the film.
    • Others are canonical examples of algorithms and libraries commonly used in creative coding. Topics explored include computer vision, generative graphics, audio-reactive feedback, physics simulation, and more.
  • A Standalone is a project that runs a single Visual System. Standalones can compile for up to three different targets: desktop, Oculus Rift, and Kinect v2 (through OSC). You can find Standalones in the OF/apps/CLOUDS/VSStandaloneName directories.
  • The main CLOUDS project is located in the OF/apps/CLOUDS/CLOUDS directory. It currently won't run as it's missing dependencies, but we're working on it. Stay tuned.


  • f to toggle fullscreen mode
  • h to toggle the GUI
  • e r t y to re-arrange the GUI