Skip to content

EduSync - A tool to generate .ics university course schedules. Use it via the Python script in the terminal or through the web app.

License

Notifications You must be signed in to change notification settings

Mohammed-Azab/EduSync_UniCalenderGenerator

Repository files navigation

University Course Schedule Generator

EduSync is a Python script and a web-based tool that generates .ics calendar files for university courses, allowing students to easily import their schedules into calendar applications like Google Calendar and Outlook.

Features

  • Interactive prompts for entering course details.
  • Requires a time slot (1-5) and weekday selection.
  • Allows weekly or biweekly session repetition.
  • Supports Lectures, Tutorials, and Lab sessions.
  • Saves schedules in structured .ics files for easy import.
  • NEW: Automatically skips sessions on German public holidays.

Usage Options

You can generate your schedule using either:

  1. Python Script (Terminal-Based)
    • Run the script locally on your machine.
    • See Usage for details.
  2. Web Version (Recommended for ease of use!)

Requirements

  • Python 3.x
  • Required packages: icalendar, pytz, holidays

Installation (For Python Script)

  1. Clone the repository:
    git clone https://github.com/<your-username>/<your-repo-name>.git
  2. Navigate to the project folder:
    cd <your-repo-name>
  3. Install dependencies:
    pip install -r requirements.txt

Usage (Python Script)

Run the script:

python EduSync.py

Follow the prompts to enter course details. The script will generate .ics files in the output/ directory.

Holiday Skipping

  • The script checks German public holidays and skips sessions falling on those days.
  • If a session falls on a holiday, it will be moved to the next available week.

Contributing

Contributions are welcome! Feel free to fork the repository, make improvements, and submit a pull request.

License

This project is licensed under the MIT License.

About

EduSync - A tool to generate .ics university course schedules. Use it via the Python script in the terminal or through the web app.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published