Service: Schedule Service - EyevinnOSC/community GitHub Wiki
FAST Engine Schedule Service
Schedule Service (serviceId eyevinn-schedule-service) is an open-source, modular service that populates schedules for FAST Channel Engine channels. It stores schedules in AWS DynamoDB, which FAST Engine reads to drive linear channel playout. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance. License: MIT.
What it can do
- Manage channel schedules through a REST API at the instance URL, for example adding VOD assets with start and end times.
- Store schedules in AWS DynamoDB tables whose names get a configurable prefix.
- Feed a FAST Channel Engine instance, which polls the schedule on each playlist request and stitches VOD content into a continuous linear HLS stream.
Creating an instance
Prerequisites: an AWS account with DynamoDB access and an IAM user with programmatic access (AmazonDynamoDBFullAccess, or a least-privilege policy with dynamodb:GetItem, PutItem, Scan, Query, UpdateItem, DeleteItem), plus the Access Key ID, Secret Access Key and an AWS Region for the tables (for example eu-north-1). A FAST Channel Engine instance that reads the same schedule is needed to play the channel.
Store the AWS credentials with create-service-secret (serviceId eyevinn-schedule-service), then create the instance with create-service-instance using serviceId: "eyevinn-schedule-service":
{
"name": "myschedule",
"tablePrefix": "mychannels",
"awsAccessKeyId": "{{secrets.awsaccesskeyid}}",
"awsSecretAccessKey": "{{secrets.awssecretaccesskey}}",
"awsRegion": "eu-north-1"
}
Wait with wait-for-service-ready, then use describe-service-instance for the instance URL. OSC CLI form: osc create eyevinn-schedule-service myschedule -o tablePrefix="mychannels" -o awsAccessKeyId=... -o awsSecretAccessKey=... -o awsRegion="eu-north-1".
Options
| Option | Required | Type | Meaning |
|---|---|---|---|
| name | Yes | string | Name of the instance. |
| tablePrefix | Yes | string | Prefix applied to all DynamoDB table names, for example mychannels. |
| awsAccessKeyId | Yes | string | IAM Access Key ID used for DynamoDB. |
| awsSecretAccessKey | Yes | string | IAM Secret Access Key used for DynamoDB. Treat as a secret and pass as {{secrets.NAME}}, which only works as the entire field value. |
| awsRegion | Yes | string | AWS Region of the DynamoDB tables, for example eu-north-1 or us-east-1. |
Treat the AWS key id and secret as secrets: store them with create-service-secret rather than putting values in the config.
Using the instance
Add a VOD asset to a channel's schedule:
SCHEDULE_URL=https://myschedule.eyevinn-schedule-service.auto.prod-se.osaas.io
curl -X POST "${SCHEDULE_URL}/api/v1/schedules/mychannel" \
-H "Content-Type: application/json" \
-d '{
"title": "Big Buck Bunny",
"start_time": "2026-04-19T10:00:00.000Z",
"end_time": "2026-04-19T10:10:00.000Z",
"duration": 596000,
"asset_url": "https://example.com/vod/bbb.m3u8"
}'
Point a FAST Engine instance at the Schedule Service so it reads the schedules:
osc create eyevinn-fast-engine myfastchannel \
-o ChannelsConfigUrl="${SCHEDULE_URL}/api/v1/channels" \
-o ScheduleServiceUrl="${SCHEDULE_URL}"
OSC puts an authentication gate in front of instance URLs other than /, so API calls from outside may need a service access token.