How-To Guides on go-rtmp

OBS Studio Setup

Mon, 01 Jan 0001 00:00:00 +0000

OBS Studio Setup#

This guide walks through configuring OBS Studio to stream to your go-rtmp server.

Prerequisites#

go-rtmp server running (see Quick Start)
OBS Studio installed

Step-by-Step Configuration#

1. Stream Settings#

Open OBS → Settings → Stream:

Setting	Value
Service	Custom…
Server	`rtmp://localhost:1935/live`
Stream Key	`mystream`

Tip: Replace localhost with your server’s IP address if streaming from a different machine.

2. Output Settings#

Open OBS → Settings → Output → Streaming tab:

FFmpeg Commands

Mon, 01 Jan 0001 00:00:00 +0000

FFmpeg Commands#

Common FFmpeg commands for publishing, subscribing, recording, and converting with go-rtmp.

Publishing#

From a File#

Re-stream a video file at its original frame rate:

ffmpeg -re -i video.mp4 -c copy -f flv rtmp://localhost:1935/live/test

-re reads the file at its native frame rate (real-time). Without this flag, FFmpeg sends frames as fast as possible.
-c copy copies the codec without re-encoding (fast, no quality loss).

Test Pattern (No File Needed)#

Generate a synthetic video + audio stream for testing:

Troubleshooting

Mon, 01 Jan 0001 00:00:00 +0000

Troubleshooting#

Quick Reference#

Symptom	Cause	Fix
“connection refused”	Server not running	Start the server first
Black screen in ffplay	Missing sequence headers	Restart publisher; wait 2–3s before starting subscriber
“stream not found”	Wrong stream key	Ensure publisher and subscriber use the same `app/streamName`
High CPU	Debug logging	Use `-log-level info` instead of `debug`
Recording file empty	Publisher disconnected before keyframe	Stream for at least a few seconds
Connection dropped after ~90s	TCP read deadline	Normal for idle connections — ensure publisher is actively streaming
H.264 “mmco: unref short” warning	Joined mid-GOP	Normal and expected — decoder recovers in <1s
Auth failure	Token mismatch	Check stream key and token match exactly
Hook not firing	Wrong event name	Verify event type spelling (`connection_accept`, `publish_start`, etc.)

Connection Issues#

“Connection Refused”#

The server is not running or not listening on the expected address.

E2E Testing Scripts

Mon, 01 Jan 0001 00:00:00 +0000

End-to-End Testing Scripts#

go-rtmp includes a comprehensive suite of cross-platform E2E testing scripts in the scripts/ directory. These scripts validate the full streaming pipeline — from publishing through relay to playback — covering plain RTMP, RTMPS (TLS), HLS via hooks, and authentication.

Prerequisites#

Check that all required tools are available:

Linux/macOS:

./scripts/check-deps.sh

Windows (PowerShell):

.\scripts\check-deps.ps1

This verifies: ffmpeg, ffplay, ffprobe in PATH, and that the rtmp-server binary exists. Each tool’s version is reported.