Read only mirror: A plugin manager for fakemurk

rainestorme 1c16b5ec66 Abandon startup builder concept, moving to a seperate repo 2 ヶ月 前
.github 0eeccb32e1 Update issue templates 11 ヶ月 前
docs fd2e82092e Developer reference 6 ヶ月 前
helper 1a05c199d3 Add update button to plugin store 6 ヶ月 前
plugins ce368e65dc Add apple bootsplash 8 ヶ月 前
.gitignore 538d6c80db Basic script, untested 6 ヶ月 前
CODE_OF_CONDUCT.md 1594bb0a16 Create CODE_OF_CONDUCT.md 1 年間 前
LICENSE 6a505a8b31 Initial commit 1 年間 前
README.md 6ad18279af Update README.md 6 ヶ月 前
chromeos-bootsplash-v2.png 6d2d5f583e Add files via upload 1 年間 前
chromeos_startup.sh e2a4f10bb6 finish an un-finished comment in chromeos_startup.sh 2 ヶ月 前
common_minimal.sh 08760697ba Add common_minimal to devmode installer 11 ヶ月 前
cr50-update.conf 340e71ba7e Add more autoupdate files 1 年間 前
crossystem_boot_populator.sh aeca537f93 Greatly improve image_patcher.sh, remove unneccesary blobs and functions 11 ヶ月 前
daemon.sh 5fbea3990d Fix restore flag checking 6 ヶ月 前
image_patcher.sh 5fb9cae274 Add option to keep cros bootsplash 6 ヶ月 前
murkmod-devmode.sh af4649d1e0 Use chrome100-json instead of scraping chrome100 directly, closes #82 2 ヶ月 前
murkmod.sh 8ac1be2c72 Reunify startup scripts 10 ヶ月 前
mush.sh 4cda857f54 Add option to use original cros bootsplash, closes #69 (nice) 6 ヶ月 前
pollen.json afebd52851 Reformat pollen.json 11 ヶ月 前
pre-startup.conf 377e1f56dc Migrate from fakemurk-daemon.sh to murkmod-daemon.sh 10 ヶ月 前
ssd_util.sh aeca537f93 Greatly improve image_patcher.sh, remove unneccesary blobs and functions 11 ヶ月 前

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 (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 (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.