Service: Stream Graphics Generator - EyevinnOSC/community GitHub Wiki

Stream Graphics Generator

Stream Graphics Generator (serviceId birme-stream-gfx) creates customizable countdown timers and overlay slates for live streaming. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance under the MIT license. It provides a browser-based source that you add to OBS Studio (or any tool that supports browser sources), with 10 built-in themes. Source: birme/stream-gfx.

What it can do

  • Show a full-screen countdown timer with adjustable minutes.
  • Show a static "Starting soon" or "Be right back" slate.
  • Choose between 10 built-in themes.

Creating an instance

No dependencies and no configuration beyond a name. Call create-service-instance with serviceId: "birme-stream-gfx":

{ "name": "mystreamgfx" }

Wait for the instance to be running (wait-for-service-ready) and use describe-service-instance to get the URL.

CLI equivalent:

osc create birme-stream-gfx mystreamgfx

Options

Option Required Type Meaning
name Yes string Name of the instance. Alphanumeric, at most 20 characters.

The service has no other options. Themes and countdown time are chosen in the URL.

Using the instance

In OBS Studio, add a Browser source (the + button in the Sources panel), set the URL to the instance URL, for example https://<instance-url>/countdown?theme=1&minutes=5, and set Width and Height to match your stream resolution (for example 1920 x 1080).

Append ?theme=<number> (1 to 10) to choose a theme. Preview all themes at https://<instance-url>/.

Path Description
/countdown?minutes=N&theme=N Full-screen countdown timer
/slate?theme=N Static "Starting soon" / "Be right back" slate

Resources

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