Skip to content

Telegram bot to send weekly and daily personalised UCL timetable and reminders about upcoming lectures

License

Notifications You must be signed in to change notification settings

artem-streltsov/ucl-timetable-bot

Repository files navigation

UCL Timetable Bot

The UCL Timetable Bot is a Telegram bot that helps UCL students manage their lecture schedules by providing easy access to their timetables and sending timely notifications.

Getting Started

  1. Get your WebCal link:

    • Log in to Portico
    • Go to My Studies -> Timetable
    • Click on "Add to Calendar"
    • Copy the WebCal URL
  2. Start using the bot:

    • Open Telegram
    • Search for @ucl_timetable_bot
    • Start a chat with the bot
    • Use the /start command to begin
  3. Set up your timetable:

    • Send your WebCal URL to the bot with the /set_calendar command

Available Commands

  • /start: Begin interaction with the bot and set up your timetable
  • /set_calendar: Set and update your WebCal link
  • /today: Get today's lecture schedule
  • /tomorrow: Get tomorrow's lecture schedule
  • /week: Get this week's lecture schedule
  • /settings: View and update your notification settings
  • /add_friend: Add a friend by username
  • /accept_friend: Accept friend request
  • /set_daily_time: Set the time for daily notifications
  • /set_weekly_time: Set the day and time for weekly notifications
  • /set_reminder_offset: Set the offset in minutes for reminders before lectures

Configuring Notifications

The bot offers three types of notifications:

  1. Daily Summary: A daily overview of your lectures
  2. Weekly Summary: A weekly overview of your lectures
  3. Lecture reminders: A reminder x minutes before your lectures

To configure these notifications:

  1. Use /settings to view your current notification settings
  2. Use /set_daily_time to set when you receive daily summaries
  3. Use /set_weekly_time to set when you receive weekly summaries
  4. Use /set_reminder_offset to set when you receive lecture reminders

Time Zone Information

Important: The UCL Timetable Bot operates using UK time (either GMT or BST, depending on the time of year). This means:

  • All times displayed in notifications and summaries are in UK time.
  • When setting notification times, please use UK time.

Please keep this in mind when interacting with the bot, especially if you are in a different time zone.

About

Telegram bot to send weekly and daily personalised UCL timetable and reminders about upcoming lectures

Resources

License

Stars

Watchers

Forks

Languages