|File: [local] / projects / fauxstream / README.md (download)
Revision 1.2, Sun Jul 7 17:46:17 2019 UTC (2 years, 3 months ago) by thfr
CVS Tags: HEAD
Changes since 1.1: +73 -37 lines
fauxstream is a wrapper script for ffmpeg to simultaneously record a
desktop video stream and one (or more?) audio streams on OpenBSD.
The goal is to circumvent limitations with other streaming/recording
solutions on OpenBSD, including simpler invocations of ffmpeg(1). It
allows screencasting including monitoring and microphone audio streams.
The license is ISC (see head of fauxstream).
To my knowledge, there is no dedicated screen casting solution available
on OpenBSD as of the time of this writing. The port of ffmpeg can
fulfill these functions, but seems to be hampered by apparent lack of or
suboptimal multithreading support, resulting in dropped frames when
It turns out that the reason for this is apparently lack of (or too
little) parallelism on the side of ffmpeg.
This script circumvents this by running multiple parallel recording
streams communicating via pipes.
Note that this is likely only useful on multiprocess systems/kernels.
* ffmpeg >= 4.0 (install from ports with `doas pkg_add ffmpeg`)
* enable kern.audio.record:
# sysctl kern.audio.record=1
* Higher recording resolutions, non-default video codecs, or
simultaneously running applications may affect performance while
recording to the point of dropping frames and leading to
* The recording with ffmpeg's x11grab doesn't register when an
application goes fullscreen, and it continues to record it as being
run in a window.
* Likely significantly worse performance on single-core CPUs/
* Correctly syncing audio and video streams currently requires manually
finding the best audio offset (`-a` parameter).
* Including a webcam video feed may introduce its own lag/desync and
has not been tested by me.
Setting up the Monitoring Stream
Refer to [FAQ 13](https://www.openbsd.org/faq/faq13.html#recordmon).
fauxstream [-vmon <factor>] [-m [-vmic <factor>]] [-r <size>]
[-f <framerate>] [-a <seconds>] <target>
-m: enable microphone stream (in addition to monitoring stream)
-vmon: factor to adjust volume of the monitoring stream
-vmic: factor to adjust volume of the microphone stream
-r: set video size (resolution)
-f: set video framerate
-a: set audio offset (in seconds; can be negative)
The target can be a file or a remote streaming address (`rtmp://`).
### Stream to Twitch:
sh fauxstream -m -vmic 5.0 -vmon 0.25 -r 1920x1080 -f 30 -a -0.2 \
### Record to file:
sh fauxstream [...] /path/to/file.flv
**Q: What does the name stand for?**
A: It used to stand for **f**fmpeg + **au**cat **x**11 **stream**, but
since aucat was dropped, the name isn't an abbreviation for anything in
**Q: How do I stop the recording??**
A: Press Ctrl-C to stop the recording.