- An Intel processor with Intel Quick Sync, or otherwise some hardware
H.264 encoder exposed through VA-API. Note that you can use VA-API over
DRM instead of X11, to use a non-Intel GPU for rendering but still use
- Quick Sync (by giving e.g. “--va-display /dev/dri/renderD128”).
+ Quick Sync (Nageru does this automatically for you if needed).
- Two or more Blackmagic USB3 or PCI cards, either HDMI or SDI.
The PCI cards need Blackmagic's own drivers installed. The USB3 cards
- LuaJIT, for driving the theme engine.
- - libpci, for printing friendly PCI device names in an error message.
+ - Meson, for building.
- Optional: CEF (Chromium Embedded Framework), for HTML graphics.
If you build without CEF, the HTMLInput class will not be available 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
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 libpci-dev
+ libprotobuf-dev
-Exceptions as of February 2018:
+Exceptions as of November 2018:
- - You will need Movit from unstable; stretch only has 1.4.0.
+ - You will need Movit from testing or unstable; stretch only has 1.4.0.
- - You will need bmusb from unstable; stretch only has 0.5.4.
+ - You will need bmusb from testing or unstable; stretch only has 0.5.4.
- - Debian does not carry CEF (but it is optional).
+ - You will need a Meson backport; the version in stretch is too old.
+
+ - 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
+
+ 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,