Grim Games Live Grim Games Live

GRiMbot documentation

Schedule

This is the hosted copy of the GRiMbot technical manual. Use the table of contents to open any page in the manual.

GRiMbot product page Manual home

Schedule

Open Stream → Schedule → Schedule. This is the default GRiMbar path. Organize GRiMbar can move the window.

Schedule lists the Twitch channel schedule for one month. You can create and edit scheduled streams, skip the next occurrence of a weekly series, delete an entry, and set vacation dates. Calendar shows the same schedule in a month grid.

Before you start

  • Configure the Bot Timezone.
  • Authorize the broadcaster in System Status.
  • The broadcaster token needs channel:manage:schedule for every write.
  • One-off streams require Twitch Affiliate or Partner status.

Add a stream

  1. Use the left or right arrow to choose a month.
  2. Click New Stream.
  3. Enter the Title, Date, and Time.
  4. Choose a Duration.
  5. Turn on Repeat weekly if needed.
  6. Click Save.
  7. Confirm that the entry appears in the monthly list.

Edit or delete a stream

  1. Click Edit beside the entry.
  2. Change Title, Date, Time, or Duration.
  3. For a weekly entry, turn on Skip next occurrence only when you want to cancel the next date without deleting the series.
  4. Click Save.
  5. To remove the entry, click Delete and confirm.

Editing a recurring stream updates the entire weekly series. The Twitch category is shown when present, but this window cannot change it.

Set vacation dates

  1. Click Vacation.
  2. Choose Vacation starts.
  3. Choose the Return date.
  4. Click Save.
  5. Use Cancel Vacation to clear the saved vacation period.

Twitch shows vacation from the start date through the return date. Dates use the Bot Timezone.

Controls

Control What it does
Previous and next arrows Move one month backward or forward.
Refresh Reloads the current month from Twitch.
Vacation Opens vacation start and return date controls.
New Stream Opens the create window.
Column headings Sort the loaded monthly rows.
Edit Opens a scheduled stream for changes.
Title Sets the schedule title. Maximum 140 characters.
Date Sets the local schedule date.
Time Sets the local start time in the displayed Bot Timezone.
Duration Chooses 1, 2, 3, 4, 6, or 8 hours.
Repeat weekly Creates a weekly series.
Skip next occurrence Marks the next date in a weekly series as skipped.
Delete Removes the selected schedule segment after confirmation.
Vacation starts Sets the first vacation date.
Return date Sets the final date sent to Twitch for the vacation period.
Cancel Vacation Removes the current vacation period.

The list shows Date, Time, Title, Duration, Type, and Category. Type is Weekly or One-off.

Check the result

  • A saved entry appears in the list and in Calendar.
  • A weekly entry reads Weekly.
  • A skipped occurrence reads Skipped.
  • A vacation banner shows its start and return dates.
  • Twitch shows the same schedule after it accepts the change.

If something fails

  • If schedule writes are disabled, re-authorize the broadcaster in System → System Status.
  • If the time is wrong, correct the Bot Timezone and refresh.
  • If a one-off stream fails with a Twitch permission message, confirm Affiliate or Partner status.
  • If the vacation dates fail, set a return date on or after the start date.
  • If an entry changed on Twitch, click Refresh before editing it again.
  • If the list does not load, check Twitch API credentials and the broadcaster account.

Limits

  • Title is limited to 140 characters.
  • The API accepts durations from 30 through 1,380 minutes. The window offers the listed presets.
  • New weekly schedules repeat on the selected weekday. Twitch may start the series on the next matching weekday.
  • Category selection is not implemented in this window.