Chronicle Bot supports the syncing of calendar events from Google Calendar into Discord events.
To enable this feature, turn on the toggle for Sync Google Calendars to Discord Events and select the number of days you would like to search ahead for events.
When a calendar event is found within the search time frame the bot will create a new Discord event in your server. The new event will be a "Somewhere Else" Discord event with the Location set to your Google Calendar event's location field.
Any changes made to the event within Google Calendar will be synced over to Discord, updating the existing event. When this happens the server members who are interested in that event are retained as well as any cover image you may have set.
Discord Event Types
Discord supports three types of events, Somewhere Else, Voice Channel, and Stage Channel events
Somewhere Else Events
By default, all events are synced into Discord as Somewhere Else events with the event Location field being used as the location for the event. If this location is a link Discord will make it clickable for your members.
Voice Channel Events
Chronicle Bot supports the creation of Voice Channel events, but a specific format is required in the Location field of the event.
Voice Channel Permissions
When using a private Voice Channel in an event, Chronicle Bot must have permissions to that Voice Channel otherwise the event sync will fail.
Within your calendar create an event as you normally would, except for the Location field. In the Location field type VC: Channel Name with the channel name being the name of an existing Voice Channel on your server.
If your channel name contains emojis or other special characters you can also use the format VC: 928022410362519642 where the number is the channel ID of the desired voice channel.
Stage Channel Events
Stage Channel events work exactly like the Voice Channel events detailed in the section above. The only difference is Chronicle Bot must be added as a moderator to the stage channel, otherwise the creation of the Discord event will not succeed.
The event cover image feature is a recent addition and may change in the future. If you experience any problems, please let us know.
You can set a Discord Event cover image by adding a front matter to your event's description. Full details can be found in the front matter docs.
To add an image from your calendar event you will need to have a URL for your image and add the following to the top of your calendar event's description:
+++ cover="https://your_link_goes_here/image.jpg" +++ Your normal event description can go here...
As long as the bot can reach the image URL, and the file size is less than 4 megabytes, the image will be used as your event's cover image within Discord. Chronicle Bot will only apply this image to Discord events which do not already have a cover image.
This feature can come in handy when you use the same image repeatedly or for reoccurring events. If you are using different images for each event it is easier to add these within Discord.
Preventing Duplicate Events
When a new calendar event is found the bot looks for a duplicate event in Discord before creating a new one. If the start time, end time, and event title all match exactly, Chronicle Bot will link your calendar event to the existing Discord event.
This is useful if you use the Discord "Add to Google Calendar" feature as it prevents duplicate events from appearing.