Read only mirror: A plugin manager for fakemurk

rainestorme 8529d05ea9 Merge pull request #130 from kosuke14/revert-129-main 4 minggu lalu
.github 0eeccb32e1 Update issue templates 1 tahun lalu
docs 8c49a2db22 Update devmode installer instructions to match README 3 bulan lalu
helper 364c68a419 Update manifest.json 5 bulan lalu
plugins 94413c3abc Move bootsplashes to an external repo (fixes #71) 6 bulan lalu
CODE_OF_CONDUCT.md 1594bb0a16 Create CODE_OF_CONDUCT.md 1 tahun lalu
LICENSE 6a505a8b31 Initial commit 2 tahun lalu
LICENSE-chromiumos c6db890517 Should probably have this... 6 bulan lalu
README.md 6d32362e98 Update README.md 1 bulan lalu
chromeos-bootsplash-v2.png 6d2d5f583e Add files via upload 1 tahun lalu
chromeos_startup.sh 696c85c14f Don't prefix get_largest_cros_blockdev outputs (fixes #83) 6 bulan lalu
common_minimal.sh 08760697ba Add common_minimal to devmode installer 1 tahun lalu
cr50-update.conf 1e2bb4978a Cleanup cr50-update.conf 10 bulan lalu
crossystem_boot_populator.sh aeca537f93 Greatly improve image_patcher.sh, remove unneccesary blobs and functions 1 tahun lalu
daemon.sh 2d8eef48d1 Remove the version check 4 minggu lalu
image_patcher.sh 6a8ffbce00 Fix losetup in image_patcher (replaces #104, closes #102 and #93) 4 bulan lalu
murkmod-devmode.sh f0e19abb3f Fix losetup in devmode installer (replaces #104, closes #102 and #93) 4 bulan lalu
murkmod.sh d44a20b9b2 Remove analytics since the backend has been broken for a while 3 bulan lalu
mush.sh fac380fd0a revert: Bring back get_largest_cros_blockdev in mush 3 bulan lalu
pollen.json d01129be60 Update pollen.json 1 bulan lalu
pre-startup.conf 377e1f56dc Migrate from fakemurk-daemon.sh to murkmod-daemon.sh 1 tahun lalu
ssd_util.sh aeca537f93 Greatly improve image_patcher.sh, remove unneccesary blobs and functions 1 tahun lalu

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

[!NOTE] 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.

[!WARNING] murkmod is not officially tested on any release milestone past v118 (pheonix). It will likely continue to work on future versions, but use caution with anything >v122.

Enter developer mode (either while enrolled or unenrolled) 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 (Analytics completely removed 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 recommended if you wish to install murkmod in this way