Service: Livego - EyevinnOSC/community GitHub Wiki
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.
- 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.
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.
| Option | Required | Type | Meaning |
|---|---|---|---|
| name | Yes | string | Name of the instance. Alphanumeric/underscore only (^\w+$), at most 20 characters. |
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