Service: Test Source HLS Live - EyevinnOSC/community GitHub Wiki

Test Source HLS Live

Test Source HLS Live (serviceId eyevinn-docker-testsrc-hls-live) generates a live HLS test stream using FFmpeg. It gives you a valid, continuously-updating HLS endpoint for developing and testing video applications without a real encoder or camera. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance with up to 10 GiB of storage per instance. License: MIT.

What it can do

  • Serve a live HLS stream with a test pattern video and timecode overlay, updated continuously.
  • Provide a reliable input for testing HLS player implementations.
  • Validate stream monitoring and alerting systems.
  • Feed transcoding or packaging pipelines during development.

Creating an instance

There are no dependencies and no options besides the name. Create the instance with create-service-instance using serviceId: "eyevinn-docker-testsrc-hls-live". The instance name must be alphanumeric and at most 20 characters.

{ "name": "mytest" }

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

OSC CLI example:

osc create eyevinn-docker-testsrc-hls-live mytest

Options

Option Required Type Meaning
name Yes string Name of the instance. Letters, digits and underscore only; on OSC at most 20 characters.

Using the instance

The live HLS master playlist is at:

https://<instance-url>/live/master.m3u8

Play it in any HLS-compatible player, for example:

ffplay https://<instance-url>/live/master.m3u8

Check that it is up:

curl -I https://<instance-url>/live/master.m3u8

Limitations

  • Storage is limited to 10 GiB per instance.

Resources