vimix

Live Video Mixing

vimix performs graphical mixing and blending of several movie clips and computer generated graphics, with image processing effects in real-time.

Its intuitive and hands-on user interface gives direct control on image opacity and shape for producing live graphics during concerts and VJ-ing sessions.

The output image is typically projected full-screen on an external monitor or a projector, and can be streamed live (SRT, Shmdata) or recorded (without audio).

vimix is the successor for GLMixer - https://sourceforge.net/projects/glmixer/

License

GPL-3.0-or-later See LICENSE

Install vimix

Check the Quick Installation Guide

Linux

Download and install a released flatpak package

~$ flatpak install --user vimix

NB: Building your flatpak package is an option for testing the latest beta version from git ; instructions are here.

Download and install a released snap package (slower release frequency)

~$ snap install vimix

Install the stable debian package (slower release frequency)

~$ sudo apt install vimix

Mac OSX

Download and open a release package from https://github.com/brunoherbelin/vimix/releases

NB: You'll need to accept the exception in OSX security preference.

Build vimix

Clone

~$ git clone --recursive https://github.com/brunoherbelin/vimix.git

This will create the directory 'vimix', download the latest version of vimix code, and (recursively) clone all the internal git dependencies.

To only update a cloned git copy:

~$ git pull

Compile

First time after git clone:

~$ mkdir vimix-build
~$ cd vimix-build
~$ cmake -DCMAKE_BUILD_TYPE=Release ../vimix

Compile (or re-compile after pull):

~$ cmake --build .

Dependencies

Compiling tools:

• gcc
• make
• cmake
• git

Libraries:

• gstreamer
• gst-plugins (libav, base, good, bad & ugly)
• libglfw3
• libicu (icu-i18n icu-uc icu-io)

Optionnal:

• glm
• stb
• TinyXML2
• AbletonLink
• Shmdata

Install Dependencies

Ubuntu

~$ apt-get install build-essential cmake libpng-dev libglfw3-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-libav libicu-dev libgtk-3-dev 

Optionnal:

~$ apt-get install libglm-dev libstb-dev libtinyxml2-dev ableton-link-dev 

Follow the instructions to install Shmdata.

OSX with Brew

~$ brew install cmake libpng glfw gstreamer gst-libav gst-plugins-bad gst-plugins-base gst-plugins-good gst-plugins-ugly icu4c

Memcheck

To generate memory usage plots in massif format:

$ G_SLICE=always-malloc valgrind --tool=massif ./vimix

To check for memory leaks:

$ G_SLICE=always-malloc valgrind --leak-check=full --log-file=vimix_mem.txt ./vimix