Grim Games Live Grim Games Live

GRiMbot documentation

Calendar

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

Calendar

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

Calendar shows the Twitch channel schedule in a month grid. Select a day to add, edit, skip, or delete scheduled streams. Schedule shows the same Twitch data as a list and adds vacation controls.

Before you start

  • Configure the Bot Timezone.
  • Authorize the broadcaster in System Status.
  • The broadcaster token needs channel:manage:schedule to add, edit, skip, or delete schedule entries.
  • GRiMbot can read a public Twitch schedule with working Twitch API credentials even when schedule writes are disabled.

Use the calendar

  1. Click the left or right arrow to change months.
  2. Click Today to return to the current date in the Bot Timezone.
  3. Click a day to open its schedule below the month grid.
  4. Click + Add Stream.
  5. Enter the Title and Time.
  6. Choose a Duration.
  7. Turn on Repeat weekly if the stream should recur.
  8. Click Save.

Click Refresh to reload schedule entries and vacation dates from Twitch.

Controls

Control What it does
Previous and next arrows Move one month backward or forward.
Refresh Reloads the displayed month and vacation dates from Twitch.
Today Opens the current month and selects today in the Bot Timezone.
Day button Selects a date and shows its scheduled streams.
+ Add Stream Opens a new stream row for the selected date.
Title Sets the Twitch schedule title. Maximum 140 characters.
Time Sets the start time in the Bot Timezone.
Duration Chooses 1, 2, 3, 4, 6, or 8 hours.
Repeat weekly Creates a weekly series instead of a one-off stream.
Save Creates the new entry or saves changes to an existing entry.
Cancel Closes an unsaved new row.
Skip next occurrence Marks the next occurrence of a weekly series as skipped.
Delete Removes the selected Twitch schedule segment after confirmation.

Editing a recurring entry changes the entire weekly series. A skipped entry remains visible with a Skipped label.

Vacation dates set in Stream → Schedule → Schedule appear on the calendar. Calendar does not add or cancel vacation dates.

Check the result

  • The saved stream appears on the selected date.
  • Weekly entries show a Weekly label.
  • A skipped occurrence shows Skipped.
  • Vacation dates show a vacation notice.
  • The same entry appears in Schedule after refresh.

If something fails

  • If the window says schedule writes are disabled, re-authorize the broadcaster in System → System Status.
  • If the displayed time is wrong, correct the Bot Timezone and refresh.
  • If Twitch rejects a one-off stream, the channel may not have Affiliate or Partner status.
  • If saving fails, check that Title is present and the selected date and time are valid.
  • If deleting fails, refresh. The entry may already have changed or been removed on Twitch.
  • If no schedule loads, check the Twitch API credentials and broadcaster account.

Limits

  • Title is limited to 140 characters.
  • The API accepts 30 through 1,380 minutes, but this window offers only the listed duration presets.
  • One-off scheduled streams require Twitch Affiliate or Partner status.
  • Twitch decides the first date of a new weekly series. It may use the next matching weekday on or after today.