min
/
shimboot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
test for temporary thing
23 Commits 1 Branch 0 Tags 10 MiB
Shell 82.4%
HTML 16.2%
Nix 1.4%
Go to file
ading2210 34c3321ffe add password input to rootfs builder 2023-10-20 08:39:43 -04:00
bootloader/bin Merge branch 'driver-testing' 2023-10-20 08:05:15 -04:00
rootfs/opt add password input to rootfs builder 2023-10-20 08:39:43 -04:00
.gitignore create and populate image partitions 2023-10-02 13:53:11 -07:00
LICENSE improve docs, add license 2023-10-06 11:05:15 -07:00
README.md update roadmap and instructions 2023-10-20 08:18:09 -04:00
build.sh better rootfs patcher script 2023-10-20 08:04:19 -04:00
build_image.sh better rootfs patcher script 2023-10-20 08:04:19 -04:00
build_rootfs.sh add password input to rootfs builder 2023-10-20 08:39:43 -04:00
patch_initramfs.sh patch rootfs to add drivers 2023-10-06 21:28:40 -07:00
patch_rootfs.sh add password input to rootfs builder 2023-10-20 08:39:43 -04:00

README.md

Chrome OS RMA Shim Bootloader

This is a set of scripts for patching a Chrome OS RMA shim to serve as a bootloader for a standard Linux disto.

Current Development Roadmap:

  • build the image automatically
  • boot to a shell
  • switch_root into an actual rootfs
  • start X11 in the actual rootfs
  • ui improvements in the bootloader
  • load all needed drivers
  • autostart X11
  • host repo for patched systemd packages
  • use debootstrap to install debian
  • prompt user for hostname and account when creating the rootfs
  • auto load iwlmvm
  • host prebuilt images
  • write detailed documentation

Usage:

  1. Grab a Chrome OS RMA Shim from somewhere. Most of them have already been leaked and aren't too difficult to find.
  2. Download a Chrome OS recovery image for your board.
  3. Clone this repository and cd into it.
  4. Run mkdir -P data/rootfs to make a directory for the rootfs.
  5. Run sudo ./build_rootfs.sh data/rootfs bookworm to build the base rootfs.
  6. Run sudo ./patch_rootfs.sh path_to_shim path_to_reco data/rootfs to patch the base rootfs and add any needed drivers.
  7. Run sudo ./build.sh image.bin path_to_shim data/rootfs to generate a disk image at image.bin.
  8. Flash the generated image to a USB drive or SD card.

Note that these instructions are currently incomplete.

License:

ading2210/shimboot: Boot desktop Linux from a Chrome OS RMA shim.
Copyright (C) 2023 ading2210

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.