min
/
shimboot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
test for temporary thing
24 Commits 1 Branch 0 Tags 10 MiB
Shell 82.4%
HTML 16.2%
Nix 1.4%
Go to file
ading2210 bff62cdc23 build script fixes 2023-10-20 20:51:56 +00:00
bootloader/bin build script fixes 2023-10-20 20:51:56 +00:00
rootfs build script fixes 2023-10-20 20:51:56 +00: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 build script fixes 2023-10-20 20:51:56 +00:00
build.sh build script fixes 2023-10-20 20:51:56 +00:00
build_image.sh build script fixes 2023-10-20 20:51:56 +00: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
  • get wifi fully working
  • host prebuilt images
  • write detailed documentation

Long Term Goals:

  • get zram to work
  • eliminate binwalk dependency
  • get audio to work

Usage:

Prerequisites:

  • A seperate Linux PC for the build process (preferably something Debian-based)
  • A USB that is at least 8GB in size
  • At least 20GB of free disk space
  • An x86-based Chromebook

Instructions:

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