Proakademia2GCal: Supercharge Your Proakademia Calendar 📅✨

     

---

🚀 Tired of slow apps and messy schedules? Meet Proakademia2GCal!

Created by a first-year student at UAFM 🎓, this tool imports your Proakademia schedule straight into Google Calendar 🗓️ — fast, simple, and color-coded!

Why choose Google Calendar?

• ⚡ Instant access from any device — open it right in your web browser or via the official mobile app on iOS and Android
• 🌍 Cross-platform convenience — no need for extra apps or downloads to check your schedule
• 🎨 Vibrant color-coding for events: lectures 🖤, labs 💙, exams ❤️ — so your calendar is always clear and organized

Proakademia2GCal lets you:

• 🧹 Clean and optimize your ICS file for a smooth, error-free import
• 🗓️ Automatically create a dedicated "Study" calendar for your classes
• 🧼 Keep your calendar clutter-free by removing old events automatically

Get started:

• 🐍 Use the flexible Python script for maximum control
• 🚀 Or download ready-to-run apps for Windows 💻 and Linux 🐧

Simplify your study life — schedule smarter, not harder!

🚀 Quick Preview

See the magic happen! ✨ This animation shows how the script imports your ICS schedule into Google Calendar.

🗓️ Calendar View

Before	After

📝 Event Description View

Before	After

Color legend (event types):

• ❤️ Tomato – Exam
• 💜 Grape – Online or Cancelled
• 🖤 Graphite – Lecture
• 💚 Basil – Class / Seminar
• 💙 Peacock – Laboratory
• 💛 Banana – Other / Unknown

You can change colors by editing the COLORS dictionary and related conditions in the code.

💻 Quick Install & Run

Want it fast and easy? Use the compiled executables from Releases!

• Windows: Grab ics_edit_windows.exe and go!

• Linux: Grab ics_edit_linux and go!

Heads up! For those sweet color-coded events like in the preview, you'll need the Python script and ics_import (see Examples above). The executables handle the core import, but Python unlocks the color magic ✨.

🗓️ ICS File Import Guide

This is a general guide on how to import an ICS file into Google Calendar.

🛠️ Installation & First-Time Setup

Getting started is easy — just follow these steps to supercharge your schedule with a few commands! ⚡

1. 💾 Clone the Repository

First, grab the project from GitHub:

git clone https://github.com/Anghkooey/Proakademia2GCal

2. 📦 Install Required Libraries

Before launching the script, make sure you have all dependencies:

pip install gcsa ics pytz oauthlib httplib2

3. 🚪 Enter the Source Directory

All the Python magic happens inside the src/ folder. Navigate there:

cd Proakademia2GCal/src

Your environment is now ready to sync your academic calendar like a pro! ✅

🔑 Setup Google API Credentials

This step allows the script to connect to your Google Calendar securely via OAuth2.0 🔐

Follow These Steps:

1. 🎛️ Create a Google Cloud Platform (GCP) Project: 👉 Step-by-step guide ☑️ Make sure to enable the Google Calendar API in your project.

2. 🧾 Configure the OAuth Consent Screen: 📘 Follow this guide Let Google know who’s asking for access (you).

3. 🔑 Create OAuth 2.0 Client ID Credentials: 🛠️ Use this official guide Then, download the generated credentials.json file.

4. 🗂️ Place Your Credentials Correctly: Move or copy the credentials.json to the following directory in your home folder:

   ~/.credentials/credentials.json

   💡 If the .credentials/ directory doesn't exist — just create it!

📚 Need a visual walkthrough? Google provides a great Python Quickstart that walks you through the steps.

🎉 Usage

🗓️ Example 1: Import to a Specific Calendar

from main import ics_import

calendar_id = "YOUR_CALENDAR_ID"  # Replace with your actual Calendar ID
ics_import(calendar_id)

(Assuming you have calendar_id defined in config.py)

🌐 Example 2: Create a New Calendar and Import

from main import ics_import

ics_import()

🕰️ Example 3: Edit ICS File (Adjust Time Zone)

from main import ics_edit

ics_edit()

This function helps clean up and adjust event times.

⚙️ How It Works

• Calendar Handling: Creates a new "Study" calendar or uses an existing one.
• Time Zone Magic: Ensures events are in your calendar's time zone.
• Cleanup Crew: Removes old events to keep your calendar tidy.
• Color Coordination: Assigns colors based on event type.

🎨 Customization

• ICS File Path: Modify ics_path to use a different ICS file.
• Authentication: Set open_browser=False if you've already authenticated.

🤝 Contributing

Feel free to contribute! Fork the repository, create a branch, and submit a pull request. Let's make this script even better together! 💪

📜 License

Licensed under the GNU General Public License v3.

📚 Documentation

For detailed information about the gcsa library, visit: gcsa Documentation

---

Google Calendar icon by Icons8