X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=intro.rst;h=131ab9d6e088c689125e050043e08d0803654b36;hb=HEAD;hp=01850ca9abfd29f6264b9a7874748fbafeeea785;hpb=f90427a692475f3d130d0188b6315766d47c8594;p=nageru-docs diff --git a/intro.rst b/intro.rst index 01850ca..131ab9d 100644 --- a/intro.rst +++ b/intro.rst @@ -45,48 +45,92 @@ usually give you a newer version). It currently need: - Qt 5.5 or newer for the GUI. - - QCustomPlot for the histogram display in the frame analyzer. + - QCustomPlot for the histogram display in the frame analyzer + (no longer needed from Nageru 2.2.0). - libmicrohttpd for the embedded web server. - 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 5.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 - to critical stability bugfixes), and with NVIDIA's proprietary drivers. - AMD's proprietary drivers (fglrx) are known not to work due to driver bugs; - I am in contact with AMD to try to get this resolved. + Nageru has been tested with Intel on Mesa), and with NVIDIA's proprietary drivers. + The status of AMD's proprietary drivers is currently unknown. - libzita-resampler, for resampling sound sources so that they are in sync between sources, and also for oversampling for the peak meter. - - Lua, for driving the theme engine. + - LuaJIT, for driving the theme engine. You will need at least version 2.1. - - libpci, for printing friendly PCI device names in an error message. + - libjpeg, for encoding MJPEG streams when VA-API JPEG support is not + available. + - Protocol Buffers (protobuf), for storing various forms of settings and + state. -If on Debian stretch or something similar, you can install everything you need + - Meson, for building. + + - Optional: CEF (Chromium Embedded Framework), for :doc:`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 + + Download the right build for your platform (the “minimal” build + is fine) and add -Dcef_dir=/cef_binary_X.XXXX.XXXX.XXXXXXXX_linux64 + on the meson command line (substituting X with the real version as required). + + - Optional: libsrt, for SRT inputs (by default, Nageru will listen on + port 9710, although you can change this port on the command line, + turn it off with --srt-port -1, or turn it off live in the UI). + SRT can also be used for output in addition to listening for HTTP + (see --srt-destination). If you build with libsrt, make sure it is not + linked to OpenSSL, for license reasons. + + - Optional: SVT-AV1, for encoding high-quality video suitable for streaming to + end users (higher quality than using x264, but not nearly as mature). + You will need at least version 1.5.0. + + +:doc:`Futatabi ` also needs: + + - A fast GPU with OpenGL 4.5 support (GTX 1080 or similar recommended for + best quality at HD resolutions, although 950 should work). + + - SQLite, for storing state. + +If on Debian bullseye or something similar, you can install everything you need with: - apt install qtbase5-dev libqt5opengl5-dev qt5-default libqcustomplot-dev \ - pkg-config libmicrohttpd-dev libusb-1.0-0-dev liblua5.2-dev \ + + apt install qtbase5-dev libqt5opengl5-dev qt5-default \ + pkg-config libmicrohttpd-dev libusb-1.0-0-dev libluajit-5.1-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 libpci-dev + libprotobuf-dev libsqlite3-dev meson libjpeg-dev libsrt-gnutls-dev + + +Exceptions as of September 2023: -Exceptions as of July 2017: + - 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 - - You will need Movit from unstable; stretch only has 1.4.0. + meson obj -Dcef_dir=/usr/lib/x86_64-linux-gnu/cef -Dcef_build_type=system -Dcef_no_icudtl=true - - You will need bmusb from unstable; stretch only has 0.5.4. 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 (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 and Futatabi use Meson to build. For a default build, type + + meson obj && cd obj && ninja + +To start it, hook up your equipment, and then type “./nageru”. + +