{"id":17456076,"url":"https://github.com/trympet/lockdown-browser-bypass-macos","last_synced_at":"2025-06-20T10:39:23.837Z","repository":{"id":52717298,"uuid":"261142792","full_name":"trympet/lockdown-browser-bypass-macos","owner":"trympet","description":"Browse the internet while using Respondus LockDown Browser or ItsLearning Test Mode Browser.","archived":false,"fork":false,"pushed_at":"2021-04-20T10:03:00.000Z","size":26,"stargazers_count":46,"open_issues_count":7,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-19T18:41:17.103Z","etag":null,"topics":["itslearning","itslearning-test-mode","lockdown-browser","lockdown-browser-bypass","provemodus","respondus","respondus-lockdown-browser"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trympet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-04T10:24:45.000Z","updated_at":"2025-03-01T17:30:54.000Z","dependencies_parsed_at":"2022-08-21T21:40:18.064Z","dependency_job_id":null,"html_url":"https://github.com/trympet/lockdown-browser-bypass-macos","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/trympet/lockdown-browser-bypass-macos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trympet%2Flockdown-browser-bypass-macos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trympet%2Flockdown-browser-bypass-macos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trympet%2Flockdown-browser-bypass-macos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trympet%2Flockdown-browser-bypass-macos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trympet","download_url":"https://codeload.github.com/trympet/lockdown-browser-bypass-macos/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trympet%2Flockdown-browser-bypass-macos/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260927828,"owners_count":23084101,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["itslearning","itslearning-test-mode","lockdown-browser","lockdown-browser-bypass","provemodus","respondus","respondus-lockdown-browser"],"created_at":"2024-10-18T02:24:09.364Z","updated_at":"2025-06-20T10:39:18.818Z","avatar_url":"https://github.com/trympet.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LockDown Browser Bypass for MacOS\nBrowse the internet, using a PIP browser window, while using [Respondus LockDown Browser](https://web.respondus.com/he/lockdownbrowser/) or [It's Learning Test Mode Browser](https://support.itslearning.com/en/support/solutions/articles/7000053270-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.\n\n## How it works\nUnlike 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](https://en.wikipedia.org/wiki/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.\n\n## I'm on Windows!\nIf 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](https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-showwindow) and [SetWindowPos](https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-setwindowpos) function, for instance in a PowerShell script. Feel free to send a PR if you have a working implementation on Windows :)\n\n## Prerequisites\n1. [Helium](https://github.com/JadenGeller/Helium)\n1. Python 3. If you don't have Python 3, (check with `$ which python3`), see [this resource](https://installpython3.com/mac/).\n\n## Installation\n1. Clone the repository and install dependencies.  \n```\ngit clone https://github.com/trympet/lockdown-browser-bypass-macos.git ~/Documents/lockdown-browser-bypass \u0026\u0026\ncd $_ \u0026\u0026\npip3 install -r requirements.txt \u0026\u0026\nchmod +x lockdown-bypass.py\n```\n\n## Usage\n1. Place Helium app inside of lockdown-browser-bypass directory (search in spotlight, drag into folder)\n2. Start Helium\n3. Start the script: `python3 ~/Documents/lockdown-browser-bypass/lockdown-bypass.py`   \n4. Within 10 seconds of starting the script, click a valid lockdown browser URL to start the lockdown browser session.   \nYou can use [this site](https://webassign.com/instructors/features/secure-testing/lockdown-browser/) to test it out\n\n## Troubleshooting\n  Make sure that you have completeted the prerequistes and installed Helium, Python 3, and the repository correctly.\n\n  ***Note*** : When attempting to run the script, you may recieve this error:\n\n  \u003e\"File \"lockdown-bypass.py\", line 4, in\n  \u003efrom Cocoa import *\n  \u003eImportError: No module named Cocoa\"\n\n  Complete the above steps for troubleshooting and it should resolve, run script as outlined in Usage.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrympet%2Flockdown-browser-bypass-macos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrympet%2Flockdown-browser-bypass-macos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrympet%2Flockdown-browser-bypass-macos/lists"}