Read only mirror: A plugin manager for fakemurk

rainestorme 1a8e55dc81 Install sh plugins even when depended on by js plugin hai 1 ano
.github 0eeccb32e1 Update issue templates hai 1 ano
docs 07c2b6f8af Merge branch 'main' of https://github.com/rainestorme/murkmod into plugin-dependencies hai 1 ano
example-plugins 3a3ae971d5 Create create-file.sh hai 1 ano
helper 1a8e55dc81 Install sh plugins even when depended on by js plugin hai 1 ano
plugin-docs ce6ba76f15 Create wssocks.md %!s(int64=2) %!d(string=hai) anos
plugins 54d4df7287 Test plugins hai 1 ano
CODE_OF_CONDUCT.md 1594bb0a16 Create CODE_OF_CONDUCT.md hai 1 ano
LICENSE 6a505a8b31 Initial commit %!s(int64=2) %!d(string=hai) anos
README.md ab810e5cb8 Significantly improve readme hai 1 ano
chromeos-bootsplash-v2.png 6d2d5f583e Add files via upload hai 1 ano
chromeos_startup.sh dd58a3bbae Unfuck chromeos_startup.sh for the second time hai 1 ano
common_minimal.sh 08760697ba Add common_minimal to devmode installer hai 1 ano
cr50-update.conf 340e71ba7e Add more autoupdate files %!s(int64=2) %!d(string=hai) anos
crossystem_boot_populator.sh aeca537f93 Greatly improve image_patcher.sh, remove unneccesary blobs and functions hai 1 ano
daemon.sh 4bf5b3c37e Use an even more intelligent way to detect login hai 1 ano
image_patcher.sh 889ec3719d Fix stupid issue hai 1 ano
murkmod-devmode.sh 9065e479cf Cut quotes from milestone hai 1 ano
murkmod.sh 8ac1be2c72 Reunify startup scripts hai 1 ano
mush.sh 676ad08a97 Fix URL resolving for dependencies hai 1 ano
pollen.json afebd52851 Reformat pollen.json hai 1 ano
pre-startup.conf 377e1f56dc Migrate from fakemurk-daemon.sh to murkmod-daemon.sh hai 1 ano
ssd_util.sh aeca537f93 Greatly improve image_patcher.sh, remove unneccesary blobs and functions hai 1 ano

README.md

murkmod

murkmod is a continuation of fakemurk and mush that includes additional useful utilities, with the most prominent being a plugin manager.

Installation

[!WARNING] You should have unblocked developer mode in some capacity before following the instructions below, most likely by setting your GBB flags to 0x8000, 0x8090, or 0x8091.

Enter developer mode while enrolled and boot into ChromeOS. Connect to WiFi, but don't log in. Open VT2 by pressing Ctrl+Alt+F2 (Forward) and log in as root. Run the following command:

bash <(curl -SLk https://bit.ly/murkmod)

Select the chromeOS milestone you want to install with murkmod. The script will then automatically download the correct recovery image, patch it, and install it to your device. Once the installation is complete, the system will reboot into a murkmod-patched rootfs.

If initial enrollment after installation fails after a long wait with an error about enrollment certificates, DON'T PANIC! This is normal. Perform an EC reset (Refresh+Power) and press space and then enter to disable developer mode. As soon as the screen backlight turns off, perform another EC reset and wait for the "ChromeOS is missing or damaged" screen to appear. Enter recovery mode (Esc+Refresh+Power) and press Ctrl+D and enter to enable developer mode, then enroll again. This time it should succeed.

It is also highly reccomended to install the murkmod helper extension. To do so:

  • Download the repo from here.
  • Unzip the helper folder and place it in your Downloads folder on your Chromebook. Do not rename it.
  • Go to chrome://extensions and enable developer mode, then select "Load unpacked" and select the helper folder.

For more information on installation of murkmod, including alternate instructions, see docs/installation.md

Features

  • Plugin manager
    • Multiple supported languages: Bash and JavaScript (Python support is in the works)
    • Easy system development: Plugins can run as daemons in the background, upon startup, or when a user triggers them
    • Simple API: Read the docs here
  • Support for newer versions of ChromeOS (R116 and up)
    • Experimental Crouton audio support on newer versions
  • Improved privacy (Opt-in, anonymous analytics** and no automatic updates)
  • Multiple versatile installation methods
    • Direct flashing to system storage via SH1mmer-SMUT
    • Installation from VT2 via the devmode installer
    • Or upgrade any pre-existing fakemurk installation* to murkmod with a single command
  • Graphical helper extension
  • Password-protection for mush to prevent unauthorized tampering by inexperienced invidividuals
  • Automatic extension disabling to save time during repeated installations
  • Alliterated name that sounds pretty cool
  • And all base fakemurk features:
    • crossystem spoofing with crossystem.sh
    • Convenient shell access
    • Enabling and disabling extensions
    • User policy modification with Pollen
    • Built-in Crouton support

*fakemurk v1.1.0 has been the most tested with murkmod, but v1.2.1 is the latest version and is reccomended if you wish to install murkmod in this way

**Analytics are completely anonymous - based on HWID only. You can view the collected data publicly here.