MGSG Project Architecture

Project Overview

This platform provides four low-latency SRT ingest slots for remote broadcasters. Hosts can read the original SRT feeds directly into OBS, while a separate browser-compatible path is created for the private WebRTC multi-view. It is used by MGSG as a real-time green room for races, showcases, commentary, and restreaming.

The Technology Stack

Docker Containerization

MediaMTX and Nginx run as Docker services so the deployment can be recreated from the repository with minimal manual setup.

MediaMTX & SRT

Broadcasters publish H.264/AAC feeds over SRT. MediaMTX authenticates publishers and hosts, then routes the original feeds to readers and the browser conversion path.

FFmpeg Transcoding

When a source becomes available, FFmpeg copies the H.264 video and converts AAC audio to Opus before republishing the browser-compatible feed.

Nginx & HTTPS Security

Nginx serves the website, handles HTTPS and Basic Auth, and reverse-proxies the private MediaMTX WebRTC HTTP interface and Control API.

Beautiful Frontend For Your Viewing Pleasure

The client-side UI uses lightweight JavaScript and checks the MediaMTX API to determine which browser feeds are currently available.

API Integration: The viewer polls the server path list and only loads active feeds.
Graceful Degradation: Offline feeds are unloaded and replaced by the fallback artwork.
Grid Architecture: The viewer supports both a four-feed grid and isolated single-feed views without reloading the page.

Author

KingofTheBeez: Core development, UI layout, and infrastructure deployment.

Credits & Acknowledgments

Carigs: Codebase portability optimization for public release, suggestions and ideas. The goat.
MGSG Community: For testing and QA. This was built for them!

Built With

A massive thank you to the developers and maintainers of the open-source tools and protocols that make this possible:

Secure Reliable Transport (SRT): Originally developed by Haivision. Used for low-latency ingest and direct host playback.
WebRTC: Used for low-latency browser playback.
FFmpeg: Used to convert AAC audio to Opus while copying the H.264 video.
Nginx: Used for the web front-end, authentication, HTTPS, and reverse proxying.
Docker: Used to run the Nginx and MediaMTX services.
Let's Encrypt & Certbot: Used for automated HTTPS certificate issuance and renewal.

Metal Gear Speed Games Zero-Latency Restream Service