kxtzownsu/PicoShim
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

copy the kajig instead

Browse Source
This commit is contained in:
kat 2024-10-09 12:55:24 -04:00 committed by GitHub
parent 180d1b4828
commit 682afec320
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 28 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
README.md
View File

@ -1,23 +1,34 @@
# PicoShim
The smallest shim ever (that boots while still being signed)
<br>
# Overview
PicoShim is a shim made for complete minimalism.
## The smallest shim to ever come out (so far)
It is the smallest shim thats able to be made (as of 10/9/24) without modifying the kernel partition
### THIS REQUIRES A USB AND BASIC INSTRUCTION FOLLOWING SKILLS
# Build instructions
Run these commands in a **LINUX** terminal, WSL is not guaranteed to work and will not recieve support.
```
git clone https://github.com/kxtzownsu/PicoShim
cd PicoShim/builder
sudo bash builder.sh /path/to/raw-shim.bin
```
Now flash `/path/to/raw-shim.bin` to a USB and boot it in Developer Mode Recovery (dev=1 reco=1)
## How to use this
**1.** Find your board, this can be done by going to `chrome://version` and then looking for the "Platform" entry. <br />
**1a.** Once found, look at the **last** word in the line, that is your board.<br />
**2.** Download a shim at https://dl.kxtz.dev/ChromeOS/shims/PicoShim<br />
**2a.** Shims are in the `<boardname>.zip` format<br />
**3.** Open the Chrome Recovery Utility (or flasher of your choice) and open the file, and then select your USB.<br />
**4.** Once the image is done flashing, remove all external media (CD, USB, SD) and press ESC+REFRESH+PWR<br />
**5.** Insert your newly-flashed USB <br />
**6.** enjoy the smallest shim thats bootable with MP keys as of 9/11/24<br />
# Credits
kxtzownsu - writing picoshim builder
olyb - shim shrinking code
## How to compile a shim
**1.** Clone the repository with `git`, `git clone https://git.kxtz.dev/PicoShim`<br />
**1a.** If git.kxtz.dev is down, you can use <https://github.com/kxtzownsu/PicoShim><br />
**2.** cd into the newly-cloned repo with `cd PicoShim`<br />
**3.** cd into the `builder` folder<br />
**4.** Move your shim into the `builder` folder <br />
**5.** Run `sudo bash picobuilder.sh /path/to/shim.bin`<br />
**6.** Your shim should now be less than 50MiB when done.<br />
vk6 - initramfs extraction code
## GitHub
https://github.com/kxtzownsu/PicoShim
## Credits
kxtzownsu - writing picoshim & the builder
ading2210 (vk6) - the extract_initramfs code
BinBashBanana (Olyb) - the shim shrinking code