benkuper / Chataigne
Projects that are alternatives of or similar to Chataigne
Chataigne
Artist-friendly Modular Machine for Art and Technology Official website : http://benjamin.kuperberg.fr/chataigne
Intro
Chataigne is made with one goal in mind : create a common tool for artists, technicians and developers who wish to use technology and synchronize softwares for shows, interactive installations or prototyping. It aims to be as simple as possible for basic interactions, but can be easily extended to create complex interactions.
Okay, but what does it do exactly ?
While Chataigne won't do much by itself, its purpose is to be the central hub in a project involving multiple interfaces, softwares, devices and sensors. You can see it as a Conductor, which will control all the softwares with the big picture in mind. Chataigne as been designed to fit both linear shows and realtime/interactive project needs.
Seems cool, tell me more !
You can check the tutorials to better understand what and how you can use Chataigne for your projects.
Features
-
Supports communication and synchronization of the following protocols :
- OSC
- OSCQuery
- MIDI
- DMX
- Serial
- UDP
- TCP
- HTTP
- WebSockets
- PJLink
-
Supports communication and synchronization of the following hardware :
- KinectV2 (Windows only)
- StreamDeck
- Joystick
- Gamepad
- Mouse
- Keyboard
- Wiimote
- Joycon
- Sound card
- StreamDeck
- GPIO (Raspberry only)
-
Pre-configured modules for controlling softwares :
- Resolume
- Madmapper
- Millumin
- QLab
- HeavyM
- D::Light
- Reaper
- Ableton Live (through a M4L patch)
- Powerpoint
- Watchout
-
State Machine : Create both simple and complex real-time interactions and automations.
-
Time Machine : Create sequence based value and colors animations, trigger events, play audio...
-
Module Router : Easily route multiple values at once from one software to another, independant of the protocol
-
Custom Variables : Store and manipulate values, use presets and interpolate group of values.
-
Dashboard : Create your own UI and controls, customize colors and labels and control it from a web interface
-
Detective : Analyse the evolution of a parameter in time to fully understand what's going on
-
Outliner : See in one place the whole hierarchy of your session
Using the software
Compiled versions for Windows, Mac OSX and Linux are available at : http://benjamin.kuperberg.fr/chataigne/#download
If beta versions are available, they will show up on this page.
If you wish to test the latest features and commits, the bleeding-edge section is generated at each commit.
Getting Started
You can start by checking the Amazing Chataigne Documentation, made with love ! https://chataigne-goldengeek.gitbook.io/chataigne/
Also you can watch tutorials from the website and follow the interactive guide from withing the application.
Building the software
Chataigne is built on top of the JUCE frameworks. You can find more infos about it there : http://www.juce.com Chataigne is using a modified version of JUCE. So you first need to compile the Projucer from the modified version of JUCE instead of downloading JUCE :
- Clone the develop-local branch from the JUCE git here : http://github.com/benkuper/JUCE
git clone --branch=develop-local http://github.com/benkuper/JUCE
-
In the JUCE/extras/Projucer/Builds folder, choose the folder depending on you system, open the solution with your IDE and compile it or make in linux. You can then open the new Projucer app that you just built.
-
Clone Chataigne with --recursive options to integrate organicUI and timeline modules
git clone --recursive http://github.com/benkuper/Chataigne
- Launch the Projucer and open Chataigne.jucer
- Save the jucer
- Open the solution for you platform in the Builds folder
- Build the solution from your IDE and compile it or make in linux
- Check the dependency section below if you have dependency problems when running Chataigne
- Enjoy !
Dependencies
Windows running instructions
DLL dependencies :
-
For Release, you can just copy the dll files from there : http://benjamin.kuperberg.fr/chataigne/user/data/Chataigne-win-x64-release-dependencies.zip and paste them in the same folder as the generated executable (in the Binaries folder)
-
For Debug, you can get a dependency pack there http://benjamin.kuperberg.fr/chataigne/user/data/Chataigne-win-x64-debug-dependencies.zip and do the same in the Binaries/Debug folder
Linux running instructions
- Before running Chataigne, you just need to do a chmod a+x on the .AppImage file, or right-click on it and allow execution, then you're ready to play !
Troubleshooting
If you have any issue regarding the software, you can post an issue on github (preferred for code-related problems and features), there is also the official forum here : http://benjamin.kuperberg.fr/chataigne/forum more suited for questions, wishes and user-level issues.
Chataigne is now on Discord, join and meet the community !
The Badge Zone
Libraries uses, references and other kudos
This list contains all the references to projects and libraries that Chataigne uses, either as an external libraries, or merged with and modified for Chataigne's source code.
- JUCE : https://www.juce.com
- Serial Library : https://github.com/wjwwood/serial
- MIDI Timecode, from MStarPlayer : https://github.com/ServiusHack/MStarPlayer
- Wiimote library Wiiuse : https://github.com/wiiuse/wiiuse
- Joycon library : https://github.com/CTCaer/joytime-core
- Zeroconf library Servus : https://github.com/HBPVIS/Servus
- Libartnet : https://github.com/OpenLightingProject/libartnet
- Joystick Library SDL : https://www.libsdl.org/
- HIDAPI : https://github.com/signal11/hidapi
- Microsoft Kinect SDK 2.0 : https://developer.microsoft.com/en-us/windows/kinect
Perhaps the most important
I do this on my own free time, feel free to buy me a beer :)
Are you using Chataigne on a regular basis ? Then why not support me accordingly, so I can have a more stable way to work on it !
Choose your angel weapon :