Discord TeamUP calendar bot

This bot is deprecated and doesn't work with the recent Discord API changes

This is an unofficial TeamUP calendar bot that lets you synchronize calendar events with discord’s calendar embed and reminds you before they happen. The bot can be used by teams to schedule scrims, for community events, or just as a personal timetable with reminders. Screenshots can be found all at the bottom of this page.

If you wish to support me financially, you can do so via PayPal here: paypal.me/bluexow

Discord server for bug-reporting, ideas, etc: https://discord.gg/CCEbu6s

How to use the bot

1. Invite bot to your server using the following LINK

2. Setup bot using command !setup [prefix] [admin-mention]

   • [prefix] - prefix you wish to use for other commands
   • [admin-mention] - mention of user/role/everyone that will be able to create and change calendars (if no mention is provided - only the author has the access to the control)

• Example: !setup ! @manager - setup server with a prefix ! and give role @manager access to the controls.

3. Create a free calendar on TeamUP (or support them with the paid one).

4. Create a bot calendar using command [prefix]calendar add [timezone] [teamup-calendar-key] [channel-id]

   • [prefix] - prefix you chose in setup
   • [timezone] - timezone of the calendar (can be different from teamup). A list of eligible timezones can be found HERE.
   • [teamup-calendar-key] - Calendar key you want to sync with, it’s located right is located right after TeamUP URL. Example: kszgdz94t6wycfcfvc.
   • [channel-id] - ID of Discord channel where you want your calendar, if no channel-id is provided - the bot will create a channel for you.

5. Now all the TeamUP events will synchronize with this calendar and you can change the calendar’s embed settings. These settings will change upon the next update loop.

   • [prefix]calendar set [calendar-id] timezone [value]

     • New timezone from this LIST.

   • [prefix]calendar set [calendar-id] timetype [value] -

     • 0 - 24hours

     • 1 - 12hours

   • [prefix]calendar set [calendar-id] datetype [value] -

     • 0 - dd.mm.yyy,
     • 1 - mm/dd/yyyy

   • [prefix]calendar set [calendar-id] reminder [value]

     • Number of minutes (not 100% exact because of update times)

6. That’s it! Now when users react to the calendar with emoji 🖐️ they will receive a DM before an event happening (reminder number of minutes).

Additional information

• All-day events are colored = BLUE =

• If you put text inside TeamUP parameter Who - it will show right after the event title.

• You can create multiple calendars (even using the same calendar-key, but different timezone, etc.)

• Default [prefix] before setup is !, after setup, it’s what you chose for the given server.

• Use [prefix]help setup, [prefix]help setup and [prefix]getstarted for more information.

• If you wish to delete a calendar - delete bot’s message (the one with embed)

• If you wish to remove your server from the database - kick the bot from server

• Upon next update loop, the bot will delete everything that is missing

Source code

The bot is written in Python and you can find the source code on the GitHub page together with the guide on how to run the bot yourself.

• It is not required to host the bot yourself, you can use my hosted version (link at the top)

Screenshots

Calendar creation

Calendar embed - you can react with emoji to receive reminders

Reminder via DM with information from TeamUP event - if the given value is empty, it won’t be included in the embed.