﻿Our software runs  VolksPC Linux desktop  as an application  on Android . This release
has been tested  with KonstaKang's AOSP 16  (https://konstakang.com/devices/rpi5/AOSP16/) 
version AOSP16-20260428-KonstaKANG-rpi5.zip. We  use our own kernel build
based on KonstaKang's kernel. If you run this installation on a newer KonstaKang AOSP 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 Lineage OS 23.2 release.

RPI5 INSTALLATION
Please check ( https://www.volkspc.org/installation/ ) for general information.
These are the steps for RPI5:
1. Install the latest KonstaKang's AOSP  Android 16  RPI5 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
Lineage OS release.

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

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


RPI5 ISSUES
The Android 16 QPR2 or newer release has good support for Android desktop mode on the secondary display. You may need to enable it
in Developer options->Window Management-> Enable desktop experience features. Our VolksPC desktop works well but  needs
to run in full-screen, so us the window decorations on Android to put the Desktop app in full-screen mode.

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.


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

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

