commit 9a13d12a433968e157a401c636a883fa3d0c29dc Author: Vichingo455 Date: Sun Jun 1 13:01:27 2025 +0000 Add Instructions diff --git a/Instructions.md b/Instructions.md new file mode 100644 index 0000000..0b5d00e --- /dev/null +++ b/Instructions.md @@ -0,0 +1,52 @@ +## Understanding the SEB Patch +This is a Patch to remove ALL the restrictions of Safe Exam Browser. It ships with Kiosk Mode completely off as well as almost no restrictions. +To apply this patch you need administrator privileges in the target machine. Note that this patch is done for demo purpouses only. +Chating in exams is forbidden and may lead to severe consequencies, you are responsible for what you do. +* The patch consists of modified and recompiled Safe Exam Browser files to remove restrictions +* When you hit patch on the patcher, it creates a backup copy of the original SEB files (if told to) and overwrites then the original files with patched ones +* This project is legal as it follows the MPL 2.0 license which is the license SEB is released with + +### Patcher UI +The UI is very simple and easy to understand: +* The text box writes the action the patch does and eventual errors +* The backup checkbox allows to backup original files before overwriting them with patched versions +* The Patch buttons starts the Patch process + +### Patched SEB UI +The UI is almost the same as the original SEB but with: +* Obviously no virtual desktop and no Kiosk mode +* The home button +* Back and foward buttons +* Reload button +* ~~Address bar~~ (removed on latest updates as a popular request) +* Zoom function +* Find feature +* DevTools +* Shortcuts enabled (CTRL+C, CTRL+V, etc) +* Clipboard enabled + +## Getting started +* First, installing Safe Exam Browser is required. Go to the [SEB Official Website](https://safeexambrowser.org) and download it. The release must match the supported release mentioned in the repository README.md. +* Download the [latest release](https://github.com/usefulstuffs/SEBPatch/releases/latest) (click on patch-seb.exe in that screen). + +## Patching SEB +1. Close Safe Exam Browser +2. Run the patch +3. Uncheck Backup if you don't need it +4. Click patch +5. Review the logs if there's something wrong (in that textbox mentioned before, there are now INFO, WARNING and ERROR for more detailed infos) +6. Close the patch if you are satisfied and run Safe Exam Browser + +## Restoring SEB +NOTE: This is only available if the backup option has been selected in the previous phase + +1. Delete the patched SEB files (you can find which ones in the source code) +2. Remove the .backup extension from every file +3. Done + +## Updating the SEB Patch +1. Close Safe Exam Browser +2. Open the patch-seb.exe file +3. Uncheck Backup +4. Click Patch +5. Done \ No newline at end of file