]> git.sesse.net Git - nageru/commitdiff
Add some README notes about x264.
authorSteinar H. Gunderson <sgunderson@bigfoot.com>
Sun, 24 Apr 2016 21:14:11 +0000 (23:14 +0200)
committerSteinar H. Gunderson <sgunderson@bigfoot.com>
Sun, 24 Apr 2016 21:44:35 +0000 (23:44 +0200)
README

diff --git a/README b/README
index 971efbd7b2a22d4008fc0efc1759dd503eba60af..c941c04ce5e2d55f77a1f293613e37fb4547a57d 100644 (file)
--- a/README
+++ b/README
@@ -46,6 +46,9 @@ Nageru is in beta stage. It currently needs:
 
  - libmicrohttpd for the embedded web server.
 
+ - x264 for encoding high-quality video suitable for streaming to end users
+   (but see below).
+
  - ffmpeg for muxing, and for encoding audio.
 
  - Working OpenGL; Movit works with almost any modern OpenGL implementation.
@@ -67,7 +70,7 @@ with:
   apt install qtbase5-dev qt5-default pkg-config libmicrohttpd-dev \
     libusb-1.0-0-dev liblua5.2-dev libzita-resampler-dev libva-dev \
     libavcodec-dev libavformat-dev libswscale-dev libavresample-dev \
-    libmovit-dev libegl1-mesa-dev libasound2-dev
+    libmovit-dev libegl1-mesa-dev libasound2-dev libx264-dev
 
 
 The patches/ directory contains some patches for upstream software that help
@@ -92,6 +95,18 @@ users, but you can easily send it around in your internal network and then
 transcode it in e.g. VLC. A copy of the stream (separately muxed) will also
 be saved live to local disk.
 
+If you have a fast CPU (typically a quadcore desktop; most laptops will spend
+most of their CPU on running Nageru itself), you can use x264 for the outgoing
+stream instead of Quick Sync; it is much better quality for the same bitrate,
+and also has proper bitrate controls. Simple add --http-x264-video on the
+command line. (You may also need to add something like "--x264-preset veryfast",
+since the default "medium" preset might be too CPU-intensive, but YMMV.)
+The stream saved to disk will still be the Quick Sync-encoded stream, as it is
+typically higher bitrate and thus also higher quality. Note that if you add
+".metacube" at the end of the URL (e.g. "http://127.0.0.1:9095/stream.ts.metacube"),
+you will get a stream suitable for streaming through the Cubemap video reflector
+(cubemap.sesse.net). See --help for more information on options in general.
+
 
 The name “Nageru” is a play on the Japanese verb 投げる (nageru), which means
 to throw or cast. (I also later learned that it could mean to face defeat or