SolutionsOn airSchedule & EPG

A broadcast schedule.Like a TV channel’s.

Put shows in your channel’s schedule: a video or a whole playlist — once, every day or on chosen weekdays. Between shows the channel runs its own program, and the program guide is served as JSON.

Schedule

A schedule that runs itself.

01 / RULES

Rules, not airings

A show is a rule: “weekdays at 19:00”. Airings for the week ahead are generated automatically.

02 / SOURCE

Video or playlist

A show’s source is a single video or a whole playlist. Only your own, already processed.

03 / DURATION

From 1 minute to a day

Duration 1–1440 minutes: longer material is cut, shorter is topped up by the channel filler.

04 / TIME ZONE

Channel time zone

“Every day at 20:00” stays at 20:00 even after the clocks change.

05 / NO OVERLAP

No overlaps

One show at a time — the console won’t let shows overlap and suggests the next free slot.

06 / LIVE EDIT

Edit on the fly

The schedule is rebuilt within a minute; viewers see changes from the next airing. Pause a show or limit it to a date range.

Filler between shows

What plays between shows.

Between shows the channel program plays. The mode decides where it resumes after a show.

RESTART

From the start

Every gap starts the program over.

CONTINUE

Continue

The program picks up where the show interrupted it.

BACKGROUND

Background air

The program runs continuously; shows cover it.

EPG

A program guide in JSON.

A published channel’s guide is available at an open URL: the next 24 hours by default, up to two weeks via parameters. Next to it — what’s on now and what’s next.

  • Set the window with ?from= and ?to= in milliseconds, up to two weeks.
  • CORS is open: read the guide straight from the browser — for a site widget, an app or a Smart TV.
  • In the console — the guide for the week ahead in the channel’s time zone.
How to set it up

Three steps in the console.

01

Set the time zone

The Schedule tab: the zone your schedule lives in.

02

Add shows

Source, repeat, start time and duration.

03

Choose the filler behavior

From the start, continue or background air.

JSON EPGCORSMon–Sun1–1440 min24/7
Ingest the guide

Pull the EPG into your site, app or TV.

The guide is plain JSON over HTTPS: fetch it on a timer, keep it, render it. Each entry is a scheduled show with its start and end in Unix milliseconds, a title and a poster.

  • Times are absolute UTC milliseconds — convert them to the viewer’s time zone on your side.
  • Refresh every few minutes: schedule edits reach the guide within a minute.
  • Between shows the channel plays its own program; the state URL tells you what’s on right now, including that program.
GET /public/ch/<code>/epg?from=…&to=…

{
  "code": "<code>",
  "title": "Open Movies 24/7",
  "serverTimeMs": 1794485296820,
  "entries": [
    {
      "startsAtMs": 1794513600000,
      "endsAtMs": 1794514020000,
      "title": "Caminandes marathon",
      "poster": "https://stream.dodocast.com/preview/…/cover.jpg",
      "subtitles": []
    }
  ]
}
Questions

About the program guide.

What format is the EPG?

JSON over HTTPS with open CORS. One request returns up to two weeks of shows. If your system expects XMLTV, map the fields on your side: start, end and title are all there.

Do I need an API key?

No. The guide of a published channel is public; unpublish the channel and the guide stops.

Is there a ready-made client?

The Player SDK: getChannelGuide() returns up to two weeks, getChannelState() what’s on now and next.

$20 on sign-up

Your channel is one upload away.

Sign up, get $20 on your balance and put your first video on air.

or write to hello@dodocast.com