1. CHECK DEVICE FIRMWARE VERSION AND ENABLE ADB
   This software will only work with Phones and Tablets that use GKI kernel android12-5.10.
   To determine Kernel version use the Android Settings application, i.e  Settings->About phone->Android version->Kernel version. 
   Make sure kernel version is 5.10.xxx-android12-xxx (xxx indicates values that you can ignore). 

   LineageOS builds for the Qualcomm Snapdragon SOC doesn't have "android12" in the Kernel version. So we also verify that ro.product.first_api_level
   is 31 (which is same as Android 12) before we proceed with the installation. 
   

2. This software will run on any Android device using the MediaTek Helio G99 or Snapdragon 8 Gen 1 SOC
   that runs any recent version of Android. For phones we will display on HDMI output if available.
   Examples of Helio G99 Tablet include Lenovo Tab P11 Gen 2, BlackView Tab 18, Blackview Mega 1 and  Onn 11 inch Tablet Pro (2023).
   Examples of  Snapdragon 8 Gen 1  devices include Galaxy Tab S8 and Motorola Edge+ 5G UW (2022).
   We have tested this build on the Motorola Edge+ 2022 ( https://youtu.be/hQqcjwKO9d0?si=lpww0JoxRs-ROBWW ).

3. You will need to root your Android device with Magisk to be able to install this software. 
   XDA Forum ( https://forum.xda-developers.com ) is a good place for instructions to unlock the bootloader and root.


4. VOLKSPC INSTALLATION
   Please check ( https://www.volkspc.org/installation/ ) for general information.
   You can do everything from adb.
   a. adb install InstallerAndroid12-5.10demo.apk. Ignore any warnings from Android and proceed with the installation.
   b. adb install Desktop.apk. 
   c. adb push  volkspcimgarm64.zip /sdcard/Download.

   Use the Installer application to install Linux desktop image (volkspcimgarm64.zip).
   Make sure you grant Installer root access with Magisk. After installation use Installer to start Linux desktop.
   Please read ReleaseNotes.txt for more information about the Linux desktop.
  
   This free evaluation software doesn’t handle keyboard events after 10 minutes of Linux activity. So after 10 minutes 
   the keyboard appears to be frozen on Linux but pointer and Android installation is still fully functional. 
   The Installer application can be used to upgrade your installation.

5. SOME COMMON ISSUES
   a. Our Desktop.apk needs to run full screen. Some tablets have proprietary desktop style interface which prevents our
      Desktop application from running full-screen. Please check your device and ensure that our Desktop.apk can run
      using  the complete screen.

   b. Android 16 QPR2 release has good support for Android desktop mode on the secondary display. You can enable it
      in Developer options->Window Management-> Enable desktop experience features. Future versions will not need such 
      changes. 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.

   c. For high DPI tablets, check ReleaseNotes.txt to change settings.

   d. While we support touchscreens and touchpads, some  manufacturers such as OnePlus use proprietary implementation
      that cannot be supported by the VolksPC Linux desktop. 

   e. Google’s Pixel devices  running official firmware as well as Lineage OS can be updated even after being rooted. 
      Follow these steps to upgrade and preserve root access:
         * Open the Magisk app and update it to the latest version of Magisk .
         * Install the latest Android update but don’t reboot the device. This will install Android to the the inactive slot.
         * Use Magisk to root the inactive partition and then reboot.


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

 
