hedron: A JavaScript repository from memolamogolloni

Perform live shows with your three.js creations.

Features

📥Import three.js sketches without having to recompile
🎊 Place multiple sketches in the same scene
🔊 Control variables using audio, MIDI and BPM based LFO
🕹️ Call functions using audio, MIDI and BPM based sequencer
⚡ Define macros to control multiple variables at once
⏲️ Use MIDI clock input or tap tempo to get BPM
🌇🎚️🌋 Create many scenes and crossfade between them
🔍 Preview and compose scenes before displaying them to the audience
💡 Use MIDI Learn to quickly assign controls
🔥 Hot reload your sketches on code changes, without affecting the rest of the scene
⚙️ Support for multiple MIDI control modes (abs, rel1, rel2, rel3)
📽️ Easily send output picture to external display
💾 Save / load using JSON project files

Hedron in action

Getting Started

Install

Download the latest release or build from source.

Load example project

Download the latest example projects zip from the releases page. If you've compiled from source, you'll already have the example projects, found in /example-projects.
In Hedron, choose "Load Existing Project". Choose a folder from the example projects (Logo is a good start!) and open project.json.
Play it some music, tap BPM, experiment with the controls
👽

User Guide

Head to the User Guide to learn how to use Hedron.

Creating Sketches

Head to the Creating Sketches Guide to learn how to create sketches.

Get in touch

Made something awesome in Hedron you'd like to share? Need help or have some cool ideas? Let's talk! Find Alex on Twitter: @funtriangles, or email: alex@funwithtriangles.net.

Contributing to Hedron

If you are having fun with Hedron, we'd love you to help with development. See the repo issues for what needs doing. We're particularly looking for developers who know about:

React/Redux
three.js/WebGL
Javascript performance
Spout/Syphon/C++ (related issue)
Audio analysis (related issue)

How to contribute

Fork a branch from dev
Make changes
Make a pull request to dev

Don't worry too much if the tests aren't passing, we can work on that together. :)

Build From Source

Building from source gives you some extra development features such as setting a default project that will always load on start.

Make sure Node.js and Yarn are installed on your machine.
Open terminal and run the commands below.

$ git clone https://github.com/nudibranchrecords/hedron.git
$ cd hedron
$ yarn
$ yarn start

yarn start opens the app in dev mode, you'll probably want to close the dev tools on the right hand side of the window.

Run yarn dist to package up the app for best performance and no dev tools. Once the build is complete, you'll find the app inside /dist.

Note for Windows users: Hedron doesn't seem to play nice inside of Windows Subsystem for Linux (WSL). So just install Node and Yarn natively and work like that. If you do get it working with WSL, please let us know via the issues!

Dev scripts

script	description
`yarn start`	Run in dev mode
`yarn dist`	Package the app
`yarn lint`	Run linting
`yarn test`	Run pre deployment tests (including linting)
`yarn test:dev`	Run tests on file changes (does not include linting)

memolamogolloni/hedron