dmitriykovalev / rpi-image

rpi-image

search

This command uses the same image list as Raspberry Pi Imager.

Latest Raspberry Pi OS images:

./rpi-image search

Latest images from all vendors (takes some time):

./rpi-image search --recursive

Filter by image filename using --suffix option:

./rpi-image search --suffix buster-armhf-lite

Print detailed information using --json or -J option:

./rpi-image search --suffix buster-armhf-lite --json

and use Python interpreter to pretty print:

./rpi-image search --suffix buster-armhf-lite --json | python3 -m json.tool

download

Download image file and verify its checksum:

./rpi-image download --suffix buster-armhf-lite

list

List image partitions:

sudo ./rpi-image list -i test.img

expand

Expand last partition size by 128M:

sudo ./rpi-image expand -i test.img -s +128M

Set last partition size to 2G (must be bigger than the current size):

sudo ./rpi-image expand -i test.img -s 2G

append

Append new 128M partition:

sudo ./rpi-image append -i test.img -s 128M

Append new 1G partition, setup ext4 filesystem, use data as volume label:

sudo ./rpi-image append -i test.img -s 1G -fs ext4 -l data

delete

Delete last partition:

sudo ./rpi-image delete -i test.img

run

Run interactive shell inside the image:

sudo ./rpi-image run -i test.img

Run interactive shell as logged in pi user inside the image:

sudo ./rpi-image run -i test.img -u pi

Run /bin/ls inside the image:

sudo ./rpi-image run -i test.img /bin/ls

Run command inside the image as logged in pi user:

sudo ./rpi-image run -i test.img -u pi pwd

or

sudo ./rpi-image run -i test.img -u pi -- ls -la

Run shell script inside the image:

cat script.sh | sudo ./rpi-image run -i test.img -- /bin/bash

Run shell script with arguments inside the image:

cat script.sh | sudo ./rpi-image run -i test.img -- /bin/bash -s - arg1 arg2

Run shell script with arguments inside the image by mounting shell script file:

sudo ./rpi-image run -i test.img --bind-ro script.sh:/script.sh -- /script.sh arg1 arg2

Enable ssh:

sudo ./rpi-image run -i test.img touch /boot/ssh

Print OS info:

sudo ./rpi-image run --read-only -i test.img cat /etc/os-release