Our software runs  VolksPC Linux desktop  as an application  on Android . This release
has been tested  with KonstaKang's Lineage OS 22.2 (https://konstakang.com/devices/rpi4/LineageOS22/) 
version lineage-22.2-20250826-UNOFFICIAL-KonstaKANG-rpi4.zip. We  use our own kernel build
based on KonstaKang's kernel. If you run this installation on a newer KonstaKang release it will 
still use our kernel.  However we  plan to keep our software updated regularly. Android doesn't need 
to be rooted to run the Linux desktop. This release should also work with KonstaKang's AOSP 15 release.

RPI4 INSTALLATION
Please check ( https://www.volkspc.org/installation/ ) for general information.
These are the steps for RPI4:
1. Install the latest KonstaKang's LineageOS 22.2 (Android 15) RPI4 release.   
2. Extend /data partition by flashing KonstaKANG-rpi-resize.zip with TWRP.
3. Install volkspcupdate.zip (included here) with TWRP. This installs our startup script volkspc.rc 
   at /vendor/etc/init as well as our kernel (Image).

If you installed KonstaKangs's OTA update package after installation of volkspcupdate.zip (step 3), please reinstall 
volkspcupdate.zip so that you are still using our kernel. The procedure is similar if you prefer to use KonstaKang's
AOSP release.

Now in Android install InstallerRPI4.apk, Desktop.apk and copy volkspcimgarm64.zip to /sdcard/Download.
Use the Installer application to install Linux desktop image (volkspcimgarm64.zip).
After installation reboot RPI4 and use Installer to start Linux desktop.
Please read ReleaseNotes.txt for more information about the Linux desktop.

This release doesn't support NVME installation but has been tested with both SD card and USB drive. We expect that this build
should also work with EMMC (Compute Module 4 ).

RPI4 ISSUES
The Installer application cannot locate volkspcimgarm64.zip on external USB drive.
So use Android file manager or adb to copy volkspcimgarm64.zip to /sdcard/Download.

On first boot to VolksPC desktop Android will show "Viewing full screen..." and
both Android and Linux cursor will be visible. Just use Android pointer to dismiss
the notification and everything will work after that.


VOLKSPC SOFTWARE LICENSE
This distribution includes VolksPC's proprietary software libraries, applications, scripts 
and kernel modules. This is an incomplete list of software components: 
1. VolksPC X11 graphics libraries.
2. VolksPC kernel module.
3. VolksPC Android applications- InstallerXXX.apk and Desktop.apk
/*
 * Copyright (C) 2014 - 2025  VolksPC LLC http://www.volkspc.org,  All Rights Reserved.
 * These files are part of the VolksPC software and may not be distributed, sold, 
 * reproduced or copied in any way.
 */

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING 
BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 
NONINFRINGEMENT. IN NO EVENT SHALL VOLKSPC LLC BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

OTHER SOFTWARE LICENSE
Most of the software used in this distribution is based on Debian (https://www.debian.org/legal/licenses/)
The licenses used are also listed at /usr/share/common-licenses/ in the Debian file system.
You can download our changes to GPL/LGPL software from https://www.volkspc.org/gpl-lgpl-software/.

RPI4 LINEAGEOS KERNEL SOURCE
Build instructions as https://github.com/raspberry-vanilla/android_kernel_manifest
We have not changed KonstaKang's kernel other than config settings.

