How to install the downloaded image?

[paolosezart]

I downloaded the OS image from https://konstakang.com/devices/rpi4/LineageOS21-ATV . I installed PINN on the USB-SSD and copied the file lineage-21.0-20240816-UNOFFICIAL-KonstaKANG-rpi4-atv.img to the os folder on the USB-SSD. Just in case, I copied the zip file of lineage-21.0-20240816-UNOFFICIAL-KonstaKANG-rpi4-atv.zip to the os folder on the ssd disk. After downloading PINN on my raspberry pi 4B I didn't understand how to install the already copied operating system image. There is no option to install from disk in PINN menu. How to solve this problem? I would not like to use online installation, because my ISP slows down very much downloading files from https://sourceforge.net/ and https://github.com/ (on my computer I download via proxy at 180 megabits per second). While directly, the download speed is limited to 100-500 kilobits per second.
How can I solve this problem? Please write in detail how to install already downloaded images with PINN. Also, it would not hurt to specify in what format PINN “understands” operating system image files.

Thank you for your excellent development.
I hope my problem is easily solved.

[procount]

PINN does not install OS image files (*.img). These must first be converted by separating the file content of the image (from the partition layout) into *.tar.xz files. This is necessary because PINN needs to alter the partition layout in order to install multiple OSes. Each OS also needs additional meta files that tell PINN how to download and install it, and slideshow files displayed during the installation. So each converted OS comprises about 10 files stored in a folder, typically on sourceforge.net. So the usual operation of PINN is to install these OSes directly from the internet.

If this is too slow for you, you can download these folders onto a separate USB stick and then use PINN to install them from your USB stick to your SD card. PINN includes a download feature to do just this. However, if you need to download them manually via some other means, then you can do so. You just need to follow the chain of JSON files to find the correct URL of the OS folder you want, starting at: http://raw.githubusercontent.com/procount/pinn-os/master/os/repo_list.json.

I have just been answering another issue where my response is equally applicable to this question, so please refer to #835 (comment) for further details.