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.