Scheduler

Overview

A desktop application built with PyQt6 that parses university timetables (Excel files) and syncs them with a Google Calendar.

Setup Instructions

1. Google Cloud Project Setup

To allow the app to interact with your Google Calendar, you need to create OAuth 2.0 credentials:

1. Create Project: Go to the Google Cloud Console and create a new project.
2. Enable API: In the project, navigate to APIs & Services > Library, search for "Google Calendar API", and click Enable.
3. Configure OAuth Consent Screen:
   • Navigate to APIs & Services > OAuth consent screen.
   • Select External for User Type.
   • Fill in the required App Information.
   • Under Test users, add your own Google email address (this is crucial for testing).
4. Create Credentials:
   • Navigate to APIs & Services > Credentials.
   • Click Create Credentials > OAuth client ID.
   • Select Desktop app as the application type.
   • Once created, download the JSON file using the download icon.
5. Save Credentials:
   • Create a folder named creds in the root of the project (Scheduler/creds/).
   • Rename the downloaded JSON file to credentials.json and save it as Scheduler/creds/credentials.json.

2. Running the Application

1. Virtual Environment: It is highly recommended to use a virtual environment:

   python -m venv venv
   # Linux/macOS:
   source venv/bin/activate
   # Windows:
   venv\Scripts\activate

2. Install Dependencies:

   pip install -r requirements.txt

3. Launch:

   python main.py

On the first run, the application will open a browser window asking you to authorize the app to access your Google Calendar.