Portal Update Checker

Check for any updates in your application portal for different universities with the same application.


Introduction


Portal update checker is a simple program that can check if there's any updates to your university portals without having to manually login through a browser. It is built to work, primarily with US colleges that require a Common Applcation and have a portal where any updates to the application are posted. Right now, it's not able to tell if you've been accpeted or rejected, but it can show if any updates have been released.

Portal update checker assumes that you have the same email and password for all of your portals. You will be prompted to enter your email and password at first, then you add a list of universities you have applied to. Portal Update Checker runs a browser in the background, uses the email and password you have stored to login and checks if any updates have been posted to the portal. Portal Update Checker logins and retrieves information from all universities you have added, so you don't have to manually login.

Installation and Usage Guide

  • 1. Download the python file or executable from here. and run it.
  • 2. Click the "Set Up Login Credential" button and enter your email and password. You email and password is being stored locally on a database.
  • 3. Add Universities that you have applied to using "Add Universities" button. Info on which universities are supported are provided here. Details about how to format your URL is given here
  • 4. You can check for updates using the "See Results" button.

Download and Install #back to top

Portal Update Checker is written in Python3 using Qt framework. If you want, you can clone the python source file from its GitHub Repo here. Dependencies and instructions for using the source code can be found here.

The single-file executable versions for Windows and Linux are provided below. (Sorry, I don't have access to Mac, so I can't create a Mac compatible executable. If anybody can run python in Mac and wants to contribute send me an email.)

Windows

Download

Linux

Download

Supported Universities #back to top

Portal Update Checker works with portals that are somehow associated with "technosolutions.net". They are usually the ones that send you a Pin code to your email when your application is recieved, and to set up the portal, you have to enter date of birth then set up a password. As a rule of thumb, to see if a university is supported open the email where you got the portal info, and see the link that leads you to the portal. If the link has "mx.technosolutions", then you're good to go. If not, see if the portal fits the features below.

Login Page #top

Log in page is the best method for verifying if a portal is supported. The image above is the login page for Brown, and pretty much all other portals have similar ones. In particular, there are these common features.

  • 1 There's a message right above the email address with a green streak that says "To log in, please enter your email address and password."
  • 2 The "Forgot your password" link is right next to the password field.
  • 3 The size of the login button may differ, but its color is usually a shade of grey.

Status page #top

Status pages can be very different. Usually, there's a checklist detailing application checklist and their statuses like the one above. Some might not. There's also usually a section called "Verify Adress", where your mailing address is listed.

Update page - #top

ALL(there's no exception in this one) supported portals have an update page,whether or not you have recieved any updates. If you haven't heard a decision back yet, the update looks like the one in the picture above. If you've got a decision, you get a page that contains the decision letter.

Getting to the update page is a bit tricky. Unless you've got your decisions back, there's no link to the update page on the portal status page. You'll need to use a bit of URL modification, which I've explained down here

Accesing update page #back to top

An update page is where your decision will most likely be released, and it's also the page Portal Update Checker will use to see if there's any update to your application.

An update page's url ends with a '/update.'. To get the update url, login to your portal, and reach the main page of the portal(The status where you have the checklists) and copy the url of the status page from your browser's address bar. For Brown, it's "https://apply.college.brown.edu/apply/status". Replace "status" in the URL with "update". The URL for Brown should now look like "https://apply.college.brown.edu/apply/update". Go to this url,(you might need to log in again) and if your get to a page that simply says "There is no update to your application status to report. ", or displays your decision letter, then that's your update URL. If you get to page that says "404" error there's something wrong with your URL.

The URL structure for the update page of all portals is {whatever}.edu/apply/update. The {whatever} section can be anything from "apply" to "engage" or "myapplication", depedning upon the university. Just copy the URL of the status page and change the "status" part to "update", and that should lead you the update page.

How to Use Applcation #back to top

Main Window #back to top

Portal Update Checker is a very sophisticated application containing not just three, but four buttons in its Main Window. Three of these buttons load up a dialog, and each dialog has its own set of functions. Isn't it wonderful how far technology has come?


Set Login Credential#back to top

Set Login Credential does exactly what it sounds like. You enter your email and password, and the program stores it in a database called "Database.db"(Can't get any more orignial than this) that is locally stored in the same folder as your python/executable file. The program will use this login credentials for logging into your portals.


Add Universities #back to top

Add Universities is where you add the names and URL of the university that you need to get the updates of. It has two basic inputs, "Uni Name" and "URL". You can put whatever name you want in "Uni Name" field, it's just for your reference, so go crazy with UC Hicago, "Stanford", or whatever overused meme you want..

The URL field is very important as this is the url that will be requested when the program tries to log in. Put only update URLs. More info here.

The data you input here will also be stored in the same database as your login credentials, i.e. the creatively named "Database.db" If, for some reason, you need to delete your database, please note that the list of your universities will also be deleted.


See Result #back to top

This is where you obsessively check for any update to your application. Select a single college from the list, or "All" to include every college on your list and click on the "Submit" button. Your updates will be displayed in the text area below.


DELETE #back to top

This insidious looking all-caps DELETE button deltes your previous user credentials. It does not do anything to your university list. If for some reason you changed your email/password or maybe you entered a wrong email/password while setting your login credentials, the DELETE button deletes it, so you can set up a new one.


Is this safe? Where is my login credential stored?
Your login credentials are stored locally on your computer in a database called "Database.db", in the same folder as the application file. The program is using that stored email and password, and logging in to your portals in the background. However, since access to the database file is not restricted, I recommend you use the program only on your personal computer. If you have to use this on a public computer, delete the "Database.db" file or press the DELETE button on the main menu to remove your credentials.

Please note that deleting the "Database.db" file also deletes the list of universities you have added, so if you plan to use the application again, do it through the DELETE button. The next time you run the program you will be prompted to enter your credentials again.

What is Portal Update Checker doing to with my portals in the background?
Portal Update Checker uses Robobrowser libaray to access and log you. It gets directly to the update page, so it can't access any of your the information in your status page. The html of the update page is parsed to know when an update is posted.

I get "Unsure...either your link is incorrect or the portal is different. Please try again." message.
This message occurs if your URL is not formatted to the update page, or if there's a problem with your network connection. Check if you have a valid network connection and try again.

Is this even legal.
You can see a detail analysis of its legality here
TLDW

License #back to top

Code released under the MIT License