fnordstream

fnordstream - multiple streams, zero leaks

fnordstream is a tool for simultaneous playback of multiple streams from Youtube/Twitch/etc.

Note: fnordstream is NOT a video player. It needs the mpv player and yt-dlp (or streamlink) to work.

• fnordstream has been tested on Linux and Windows. (For OSX display detection is not (yet) implemented.)
• fnordstream comes with a web based user interface.
• There's also a basic console mode which allows starting playback of streams playback without the web UI.
  (Advanced features such as stopping, (re)starting streams and volume control are only available through the web UI. Web UI can still be used in console mode or disabled if not needed.)
• Communication between web UI and fnordstream is done through a websocket with JSON requests and replies.
  (Basically you can put together your own tool to communicate with fnordstream through the websock. However at the moment there is no documentation for the JSON requests and responses so you have to inspect the communication in your browser and have a look at webui.js if you want to do this.)

Screenshots

Usage

• For normal web UI mode just start fnordstream and open http://localhost:8090 in your browser
• Use fnordstream -h for help
• You can allow remote clients by changing the listen address with the -listen-addr option. (Default is localhost only.)
  e.g. fnordstream -listen-addr=:8090 will make fnordstream listen on ALL interfaces.
• If you set the listen address to something other than localhost you MUST provide a comma separated whitelist of allowed clients with -allowed-ips. Web UI access will be restricted to clients given in this list.
• -allowed-ips may contain single IPs, from-to ranges and IP ranges in CIDR notation.
  e.g. -allowed-ips=127.0.0.1,::1,192.168.1.0/24,192.168.2.3,192.168.3.1-192.168.3.23
• Console mode can be invoked by supplying a profile name or an extra file as last argument.
  e.g. fnordstream Demo
• The web UI can be disabled with -no-web for console-only mode.
• fnordstream supports multi-host mode. That means the web UI can distribute viewports/streams to different fnordstream hosts.
  Fnordstream needs to run on all these hosts with appropriate -allowed-ips= configured for remote clients. Additionally, divergent websocket origins must be whitelisted - e.g. with -allowed-origins=localhost:8090

console mode

• You can either specify a profile name from the stream_profiles.json file (e.g. fnordstream Demo) or supply a simple list of streams with one URL per line.
  Example: echo -e "https://vimeo.com/640499893\nhttps://vimeo.com/325910798\nhttps://vimeo.com/1084537" | ./fnordstream -

• Streamlist filename - will make fnordstream read the list from stdin.

• ./fnordstream console-test.txt will make fnordstream read the list from the file console-test.txt

• You can also add options in this text file, e.g.:

    restart_error=false
    restart_user_quit=false
    use_streamlink=false
    twitch-disable-ads=false
    https://vimeo.com/640499893
    https://vimeo.com/325910798
    https://vimeo.com/1084537
  

• You can also add custom viewports to the screens, e.g.:

    https://vimeo.com/640499893 480 270 0 0
    https://vimeo.com/325910798 480 270 480 0
    https://vimeo.com/1084537 480 270 960 0
  

• Viewport definition is: <width> <height> <x> <y>

• If you do not add viewport definitions to the streams fnordstream will auto-generate a suitable layout.