Nageru is a live video mixer, based around the standard M/E workflow.
+Futatabi is a multicamera slow motion video server (currently undocumented).
Features:
are driven through the “bmusb” driver, using libusb-1.0. If you want
zerocopy USB, you need libusb 1.0.21 or newer, as well as a recent
kernel (4.6.0 or newer). Zerocopy USB helps not only for performance,
- but also for stability. You need at least version 0.7.0.
+ but also for stability. You need at least version 0.7.3.
- Movit, my GPU-based video filter library (https://movit.sesse.net).
You will need at least version 1.5.2.
- x264 for encoding high-quality video suitable for streaming to end users.
- - ffmpeg for muxing, and for encoding audio. You will need at least
- version 3.1.
+ - FFmpeg for muxing, and for encoding audio. You will need at least
+ version 4.0.
- Working OpenGL; Movit works with almost any modern OpenGL implementation.
Nageru has been tested with Intel on Mesa (you want 11.2 or newer, due
- LuaJIT, for driving the theme engine.
+ - SQLite, for storing Futatabi state.
+
+ - Meson, for building.
+
- Optional: CEF (Chromium Embedded Framework), for HTML graphics.
If you build without CEF, the HTMLInput class will not be available from
the theme. You can get binary downloads of CEF from
http://opensource.spotify.com/cefbuilds/index.html
Simply download the right build for your platform (the “minimal” build
- is fine) and add CEF_DIR=<path>/cef_binary_X.XXXX.XXXX.XXXXXXXX_linux64
- on the make command line (substituting X with the real version as required).
+ is fine) and add -Dcef_dir=<path>/cef_binary_X.XXXX.XXXX.XXXXXXXX_linux64
+ on the meson command line (substituting X with the real version as required).
-If on Debian stretch or something similar, you can install everything you need
+If on Debian buster or something similar, you can install everything you need
with:
apt install qtbase5-dev libqt5opengl5-dev qt5-default libqcustomplot-dev \
libzita-resampler-dev libva-dev libavcodec-dev libavformat-dev \
libswscale-dev libavresample-dev libmovit-dev libegl1-mesa-dev \
libasound2-dev libx264-dev libbmusb-dev protobuf-compiler \
- libprotobuf-dev
-
-Exceptions as of April 2018:
+ libprotobuf-dev libsqlite3-dev meson
- - You will need Movit from testing or unstable; stretch only has 1.4.0.
+Exceptions as of December 2018:
- - You will need bmusb from testing or unstable; stretch only has 0.5.4.
+ - Debian does not carry CEF (but it is optional). You can get experimental
+ (and not security-supported) CEF Debian packages built for unstable at
+ http://storage.sesse.net/cef/, and then configure Nageru with
- - Debian does not carry CEF (but it is optional).
+ meson obj -Dcef_dir=/usr/lib/x86_64-linux-gnu/cef -Dcef_build_type=system -Dcef_no_icudtl=true
The patches/ directory contains a patch that helps zita-resampler performance.
It is meant for upstream, but was not in at the time Nageru was released.
It is taken to be by Steinar H. Gunderson <sesse@google.com> (ie., my ex-work
email), and under the same license as zita-resampler itself.
-To start it, just hook up your equipment, type “make” and then “./nageru”.
+Nageru uses Meson to build. For a default build, type
+
+ meson obj && cd obj && ninja
+
+To start it, just hook up your equipment, and then type “./nageru”.
+
It is strongly recommended to have the rights to run at real-time priority;
it will make the USB3 threads do so, which will make them a lot more stable.
(A reasonable hack for testing is probably just to run it as root using sudo,