search

trympet / lockdown-browser-bypass-macos

Browse the internet while using Respondus LockDown Browser or ItsLearning Test Mode Browser.
MIT License
41 stars 8 forks source link
itslearning itslearning-test-mode lockdown-browser lockdown-browser-bypass provemodus respondus respondus-lockdown-browser

readme

LockDown Browser Bypass for MacOS

Browse the internet, using a PIP browser window, while using Respondus LockDown Browser or It's Learning Test Mode Browser (prøvemodus). THIS IS NOT FOR CHEATING/A VIOLATION OF ACADEMIC INTEGRITY This is meant as a proof of concept to show how useless LockDown Browser is. Please do not use this for cheating.

How it works

Unlike many other "hacks", this implementation does not utilize binary patching or other modifications. It simply circumvents the lockdown functionality by making a call to the window manager, telling it to put the Helium window on top after LDB has been launched. Now you have a small PIP browser that always stays on top. Also, since Helium is a picture in picture browser, the window doesn't disappear when you click outside of the bounds.

I'm on Windows!

If you are on Windows, and you have a little programming experience, you can simply fetch the window handle of the application you wish to put on top, and call the ShowWindow and SetWindowPos function, for instance in a PowerShell script. Feel free to send a PR if you have a working implementation on Windows :)

Prerequisites

  1. Helium
  2. Python 3. If you don't have Python 3, (check with $ which python3), see this resource.

Installation

  1. Clone the repository and install dependencies. 
    git clone https://github.com/trympet/lockdown-browser-bypass-macos.git ~/Documents/lockdown-browser-bypass &&
cd $_ &&
pip3 install -r requirements.txt &&
chmod +x lockdown-bypass.py

Usage

  1. Place Helium app inside of lockdown-browser-bypass directory (search in spotlight, drag into folder)
  2. Start Helium
  3. Start the script: python3 ~/Documents/lockdown-browser-bypass/lockdown-bypass.py
  4. Within 10 seconds of starting the script, click a valid lockdown browser URL to start the lockdown browser session.
    You can use this site to test it out

Troubleshooting

Make sure that you have completeted the prerequistes and installed Helium, Python 3, and the repository correctly.

Note : When attempting to run the script, you may recieve this error:

"File "lockdown-bypass.py", line 4, in from Cocoa import * ImportError: No module named Cocoa"

Complete the above steps for troubleshooting and it should resolve, run script as outlined in Usage.