Getting Started

SPX Graphics Controller (SPX-GC) is an open-source live production graphics system for broadcast and streaming. It lets you create, manage, and control HTML-based on-screen graphics — lower thirds, fullscreen overlays, countdown timers, tickers, and more — from a web browser without any specialist hardware. Available as an open web service in Eyevinn Open Source Cloud.

Prerequisites

  • If you have not already done so, sign up for an Eyevinn OSC account
  • (Optional) A running MinIO instance if you want to store templates, projects, and media in cloud storage

Create an SPX-GC instance

Navigate to the SPX Graphics Controller service. Go to the "My spx-gc" tab and click "Create spx-gc". Fill in:

  • Name: a name for your instance (alphanumeric only)
  • Username (optional): set a login username to password-protect the controller
  • Password (optional): set a login password (stored encrypted); required if username is set
  • S3TemplatesUrl (optional): S3/MinIO URL for storing HTML graphics templates
  • S3ProjectsUrl (optional): S3/MinIO URL for storing project and rundown data
  • S3MediaUrl (optional): S3/MinIO URL for storing media assets (images, videos)
  • S3PluginsUrl (optional): S3/MinIO URL for storing plugins and extensions
  • S3EndpointUrl (optional): Custom endpoint for MinIO or other S3-compatible storage
  • S3AccessKeyId / S3SecretAccessKey / S3Region (optional): S3 credentials

Click on the instance card when the status is green and "running".

Default Credentials

If you did not set a username and password, SPX-GC opens without a login prompt.

If you set a username but left the password blank, the application will ask you to configure a login policy on first launch.

Using SPX Graphics Controller

Open the instance URL in your browser to access the SPX-GC web interface. The main views are:

  • Projects — Organise your graphics into projects (one per show or production)
  • Rundown — A playlist of graphic items you play out in sequence or on demand
  • Template Editor — Design and test HTML graphics templates
  • Playout — Send graphics to the renderer output (typically a browser source in OBS or vMix)

Creating a graphic

  1. Create or open a project from the Projects page
  2. Add a rundown entry and assign an HTML template
  3. Fill in the template fields (e.g. name, title, image)
  4. Click the Play button to push the graphic to the output

Integrating with OBS

Add a Browser Source in OBS pointing to:

https://<your-instance-url>/renderer/

This page receives play/stop commands from the SPX-GC controller and renders the active graphic as a transparent overlay.

CLI

osc create tuomoku-spx-gc mygraphics \
  -o Username="admin" \
  -o Password="changeme"

Resources