-Hardware requirements for getting started
-=========================================
+Hardware requirements
+=====================
Nageru is designed to be as plug-and-play as possible, but by nature,
a software video mixer requires a certain amount of hardware with associated
that you have the latest drivers for your GPU.
+.. _digital-intermediate:
+
VA-API H.264 encoding
---------------------
(for future editing or re-streaming) or sent to an encoder on another machine
for final streaming.
-Currently, only VA-API is supported for H.264 encoding, although Nageru might
+Currently, only VA-API is supported for encoding the digital intermediate, although Nageru might
support NVIDIA's NVENC at some point in the future. In particular, this means that Intel Quick
Sync Video (QSV), the hardware H.264 encoder present on all modern Intel
GPUs, is supported. QSV is more than fast enough to keep up with 720p60 in
further editing or transcoding without strong generational loss.) Thus, the
QSV stream is not intended for streaming to end users of the Internet; it will
need to be reencoded by some external means, or you can use Nageru's x264
-support (see `:doc:Streaming`).
+support to produce a user-facing stream in addition to the digital intermediate
+(see :doc:`streaming`).
By default, Nageru uses zerocopy from the GPU to the VA-API buffers in order to
reduce memory transfer bandwidth, but this depends on EGL support (as opposed to
the older GLX standard), and also that the GPU you are rendering to also
supports VA-API. NVIDIA's proprietary drivers do not support either. Unfortunately,
-this is somewhat cumbersoe to automatically detect before it's too late to do anything
+this is somewhat cumbersome to automatically detect before it's too late to do anything
about it (Qt has already initialized using EGL), so on NVIDIA
systems, Nageru will exit with an error message asking you to set *--va-display*
to your Intel GPU manually. Simply follow the instructions printed to the terminal
If you have an input source with a different resolution than the native mode
(currently locked to 720p; this will be configurable without recompiling
in the future), Nageru will scale transparently for you using a Lanczos3
-filter. This requires some extra GPU power, so if you can avoid it, use the
-native mode. Similarly, if you connect an interlaced input, Nageru will
-automatically deinterlace for you.
+filter (or rather, the :doc:`theme <theme>` will). This requires some extra GPU power,
+so if you can avoid it, use the native mode. Similarly, if you connect an
+interlaced input, Nageru will automatically deinterlace for you.
Frame rates are automatically converted; one input is designated as the
**master clock** (right-click on an input to select it as such), and gets