Skip to content

Repository files navigation

🎓 UIU Course Code Decoder

Decode course codes into full course names instantly on any webpage!

Microsoft Edge Add-ons Firefox Add-ons GitHub Release License: MIT


Welcome to UIU Course Code Decoder! Are you tired of staring at abstract course codes like CSE 3421 and trying to remember if it's "Database Management Systems" or something else? We've got you covered.

This lightweight, privacy-focused Chrome extension automatically replaces course codes with their full names on any webpage. While built with United International University (UIU) students in mind, it is entirely customizable for any university, department, or personal schedule.

📑 Table of Contents


✨ Features

  • 🪄 Automatic Decoding: Instantly decodes course codes on the pages you visit.
  • 🎓 Pre-loaded Departments: Comes fully packed with built-in databases for CSE, EEE, BBA, and Data Science courses right out of the box!
  • 🧠 Smart Parsing: Seamlessly handles course codes split across multiple lines, missing spaces, or broken by HTML tags.
  • 🖼️ Iframe Support: Works flawlessly inside embedded pages, such as Google Sheets routines!
  • 🎨 Multiple Display Modes: Choose exactly how you want to see the course names:
    • Inline: Adds the full name in parentheses next to the code.
    • Tooltip: Hover over the code to see the name in a neat tooltip.
    • Highlight: Highlights the code — hover to see the full name.
  • 📚 Built-in Course Manager: Manage everything right from the extension popup. Browse, search, and delete courses without opening new tabs.
  • 💾 Persistent Custom Courses: Import your own courses via JSON. Your custom additions are saved separately and won't be overwritten.
  • ✅ Smart Allowlist: You have full control. The extension only runs on the websites you specifically allow.
  • 📊 Chart-Safe: Automatically skips SVG elements so it won't break your Highcharts or other visual data elements.
  • 🔒 100% Private: Runs entirely locally in your browser. No tracking, no data collection.

🚀 Installation

You can install the extension directly from the Edge or Firefox Add-on stores, or manually via Developer Mode (for Chrome, Brave, Opera, etc).

Method 1: Edge & Firefox Add-on Stores

Install the extension directly in your browser:

Method 2: Manual Installation (Developer Mode)

If you want to try the latest version now:

  1. Download the Extension:

    • Go to the Latest Release Page and download the .zip file.
    • Extract the .zip file to a folder on your computer.
  2. Install on Chrome / Edge / Brave / Opera:

    • Navigate to chrome://extensions/ (or edge://extensions/).
    • Turn on Developer mode in the top right corner.
    • Click "Load unpacked" and select the extracted folder.
  3. Install on Firefox (Temporary for testing):

    • Navigate to about:debugging#/runtime/this-firefox.
    • Click "Load Temporary Add-on..." and select the .zip file directly.

The extension is now installed and ready to use! 🎉


🎮 How to Use

Demo: Highlight Mode
Course codes highlighted inline!

Demo: Tooltip Mode
Hover over the course code to see its name!

  1. Enable on a Website:

    • Visit a website where you want course codes decoded (like your routine sheet).
    • Click the extension icon in your Chrome toolbar.
    • Toggle "Enable on this site" to ON. The page will reload and start decoding!
  2. Change Display Mode:

    • Click the extension icon.
    • Under "Display Mode", choose Highlight ✨, Tooltip 💬, or Inline ✏️.

⚙️ Configuration

The extension provides a clean popup dashboard to manage your courses.

Popup Top Half Popup Bottom Half

Adding and Managing Courses

  1. Click the extension icon and select "Manage Course Database".
  2. From the sliding panel, you can search, edit, or delete existing courses.
  3. Add Custom Courses: Look for the "Add / Import Courses (JSON)" section at the bottom.
  4. Paste your course list in JSON format and click "Import & Merge":
{
  "CSE 3421": "Database Management Systems",
  "CSE 1111": "Structured Programming Language",
  "MATH 2183": "Calculus and Linear Algebra"
}

Course Manager Setup Course Manager Success

Courses are instantly merged and saved permanently! The active page will automatically refresh to show your new decodings.


❓ Troubleshooting & FAQ

Q: The extension isn't changing the course codes on a page.

  • A: Make sure you have enabled the extension for that specific website (click the icon → toggle ON).

Q: It's not working inside an embedded Google Sheet or Document.

  • A: Some embedded documents use "iframes". The extension supports iframes — just make sure the parent domain is in your allowlist.

Q: Will it break charts or graphs on my university portal?

  • A: No! The extension intentionally skips SVG elements to avoid breaking charts (like Highcharts) and other visual data elements.

Q: I pasted JSON but my courses didn't update.

  • A: Make sure your JSON is a valid, flat object (all keys and values in double quotes). A red error message will show if the format is incorrect.

Q: Will I lose my custom courses if I reload the file?

  • A: No! Custom courses are saved in a separate persistent storage layer. They will survive updates and automatically merge with the default list.

🔒 Privacy

Your privacy is our priority. All settings and course lists are saved directly in your browser's local storage. We do not track you, collect data, or send any information to external servers. Read our complete Privacy Policy for more details.


🤝 Contributing

We welcome contributions! Currently, we are missing courses from several departments. If your department's courses aren't decoded yet, we would love your help to extract and add them!

Whether you're adding missing courses, fixing a bug, or just improving the documentation, your help is deeply appreciated.

Please see our Contributing Guidelines for full details on how to get started, create a branch, and open a Pull Request. If you find a bug or have a suggestion, please open an issue.


📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Never guess a course code again – decodes UIU course codes into full names on any webpage.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages