Skip to content

An intelligent, feature-rich Chrome extension designed to help students at the Open University of Sri Lanka (OUSL) never miss another deadline.

License

Notifications You must be signed in to change notification settings

hassanmsthf11/ousl-deadline-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽ“ OUSL Perfect Deadline Tracker - A Smart Academic Companion

An intelligent, feature-rich Chrome extension designed to help students at the Open University of Sri Lanka (OUSL) never miss another deadline. This tool goes beyond simple reminders, offering a robust, automated system with progressive notifications, auto-login, and custom event management.


✨ Live Demo

Demo GIF of the OUSL Perfect Deadline Tracker


πŸš€ Key Features

  • 🎯 Smart Progressive Notifications: Don't just get one reminder. This extension sends increasingly urgent notifications as a deadline approaches:
    • 1 Week Before: Time to plan.
    • 5 & 3 Days Before: Time to get serious.
    • 24 & 1 Hour Before: Critical final warnings.
    • After Timeout: Motivational messages for recovery and support.
  • πŸ›‘οΈ Resilient Auto-Login & Refresh: Intelligently handles Moodle's session timeouts and login redirects.
    • Auto-Restores Sessions: Automatically uses saved cookies to keep you logged in.
    • Auto-Fills Credentials (Optional & Secure): Can securely store and fill your username and password for a seamless login experience.
    • Tab Explosion Prevention: Built with robust mutex locks and emergency cleanup logic to prevent the infamous Moodle redirect loop from overwhelming your browser.
  • βž• Custom Activity Management: Your academic life isn't just on Moodle. Add your own custom events, assignments, or personal deadlines directly into the tracker.
  • πŸ“Š Informative Dashboard: A clean and modern popup UI that gives you a quick overview of your academic schedule:
    • Quick stats on urgent, total, custom, and completed tasks.
    • Tabbed view for "Upcoming" and "Completed" activities.
    • A dedicated section to highlight your most urgent tasks.
  • 🚨 Dynamic Urgency System: Activities are automatically color-coded and badged based on their urgency (Overdue, Critical, High, Medium, Low), so you always know what to focus on first.
  • βš™οΈ Granular Control: A comprehensive settings panel allows you to customize every aspect of the extension, from notification timings to auto-login behavior.

βœ… Prerequisites

As this is a browser extension, the requirements are very simple.

  • 🌐 A Chromium-based Web Browser:
    • Google Chrome
    • Microsoft Edge
    • Brave Browser
    • Or any other browser that supports Chrome Extensions.

You do not need to install Python, Node.js, or any other software to use this extension.


πŸ“₯ How to Install

  1. Download: Download this project as a ZIP file and extract it to a local folder.
  2. Open Chrome Extensions: Open Chrome and navigate to chrome://extensions.
  3. Enable Developer Mode: Turn on the "Developer mode" toggle in the top-right corner.
  4. Load Unpacked: Click on "Load unpacked" and select the folder where you extracted the files.
  5. Done! The "OUSL Activity Tracker" extension is now installed. Pin it to your toolbar for easy access.

βš™οΈ How to Use

  1. Initial Login: After installing, log in to the OUSL Moodle Portal one time. The extension will automatically save your session cookies.
  2. Background Operation: The extension will now work silently in the background, periodically checking for new activities and sending you notifications.
  3. View Your Schedule: Click the extension icon in your toolbar at any time to see your full list of upcoming and completed activities.
  4. Add Custom Events: Click the "βž• Add Event" button to add personal deadlines.
  5. Customize Settings: Click the "βš™οΈ Settings" button to configure notifications and auto-login to your liking.

❀️ Support The Project

If you find this tool useful, please consider making a small donation to support future development. Thank you!

Donate with PayPal

πŸ› οΈ Tech Stack

  • Core: Vanilla JavaScript (ES6+), HTML5, CSS3
  • APIs: Chrome Extension Manifest V3 (storage, notifications, alarms, cookies, webNavigation)
  • Architecture: Resilient background service worker with a separate UI controller.

πŸ“„ License

This project is licensed under the MIT License.

About

An intelligent, feature-rich Chrome extension designed to help students at the Open University of Sri Lanka (OUSL) never miss another deadline.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published