Service: Livego - EyevinnOSC/community GitHub Wiki

Livego

Livego (serviceId gwuhaolin-livego) is a lightweight live video streaming server written in Go. It accepts RTMP streams from encoders (OBS, FFmpeg and similar) and re-serves them over RTMP, HTTP-FLV and HLS. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance. License: MIT. Source: gwuhaolin/livego.

What it can do

  • Ingest RTMP from encoders such as OBS Studio, FFmpeg or GStreamer.
  • Serve the live stream to viewers over RTMP, HTTP-FLV and HLS.
  • Support multiple rooms, each with its own channel key.
  • Supports H264 video and AAC/MP3 audio, with FLV and TS containers.

Creating an instance

Call create-service-instance with serviceId: "gwuhaolin-livego". No dependencies on other OSC services.

{ "name": "mystream" }

Verify with wait-for-service-ready or get-instance-status, then describe-service-instance for the instance URL.

Options

Option Required Type Meaning
name Yes string Name of the instance. Alphanumeric/underscore only (^\w+$), at most 20 characters.

Using the instance

Livego uses a channel key to authenticate incoming RTMP streams. Get a key for a room name (for example mystream) from the control API:

curl "https://<instance-url>/control/get?room=mystream"

The response contains a key value. Use it as the stream key in your encoder; each room has its own key.

Push RTMP to:

rtmp://<instance-url>/live/<key>

OBS Studio: Settings, Stream, Service Custom, Server rtmp://<instance-url>/live, Stream Key the key from above.

FFmpeg:

ffmpeg -re -i input.mp4 \
  -c:v libx264 -preset veryfast -c:a aac \
  -f flv rtmp://<instance-url>/live/<key>

Viewers can watch once a stream is pushed (<room> is the room name):

Protocol URL
RTMP rtmp://<instance-url>/live/<room>
HTTP-FLV https://<instance-url>/live/<room>.flv
HLS https://<instance-url>/hls/<room>.m3u8

OSC CLI equivalents:

osc create gwuhaolin-livego mystream
osc list gwuhaolin-livego
osc remove gwuhaolin-livego mystream

Resources

⚠️ **GitHub.com Fallback** ⚠️