diff --git a/Documentation/WSABuilds/Backup and Restore.md b/Documentation/WSABuilds/Backup and Restore.md index 58c3019..cf71a91 100644 --- a/Documentation/WSABuilds/Backup and Restore.md +++ b/Documentation/WSABuilds/Backup and Restore.md @@ -44,7 +44,7 @@ After removing the lines above, run the script. When the Powershell window states "Press any key to quit", at that time multiple dialouge boxes will open: -<-- --> +<-- --> > [!IMPORTANT] > ****Ignore these and do not click on anything or close these popups**** diff --git a/README.md b/README.md index 3ca4b85..09c92bb 100644 --- a/README.md +++ b/README.md @@ -205,13 +205,19 @@ v2310.40000.2.0 -➖ -➖ +✅ +✅ v2311.40000.4.0 -➖ -➖ +✅ +✅ + + +v2311.40000.5.0 +✅ +✅ + @@ -250,15 +256,7 @@
- +
@@ -280,12 +278,12 @@ - + - + @@ -310,11 +308,11 @@ - + - + @@ -326,7 +324,7 @@ - + @@ -394,7 +392,7 @@ - + @@ -429,13 +427,13 @@

  Installation

 -> [!NOTE] -> -> If you have the official Windows Subsystem For Android™ installed, you must [completely uninstall](#uninstallation) it to use MagiskOnWSA. +> [!NOTE] +> +> If you have the official Windows Subsystem For Android™ installed, you must [completely uninstall](#uninstallation) it to use MagiskOnWSA. -> [!IMPORTANT] -> -> In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup Userdata.vhdx, located at ``%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx`` before uninstallation and restore it after installation. A guide for this process is located further down in this README. +> [!IMPORTANT] +> +> In case you want to preserve your data from the previous installation (official or MagiskOnWSA), you can backup Userdata.vhdx, located at ``%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx`` before uninstallation and restore it after installation. A guide for this process is located further down in this README. --- @@ -452,8 +450,8 @@ 4. Delete the .7z archive 5. Move the newly extracted folder to a suitable location (Documents folder is a good choice), as you will need to keep the folder on your PC to use MagiskOnWSA -> [!NOTE] -> If you're updating WSA, merge the folders and replace the files for all items when asked +> [!NOTE] +> If you're updating WSA, merge the folders and replace the files for all items when asked 6. Open the Windows Subsystem For Android™ folder: Search for and double-click `Run.bat` - If you previously have a MagiskOnWSA installation, it will automatically uninstall the previous one while preserving all user data and install the new one, so don't worry about your data. @@ -513,8 +511,8 @@ ### How do I update without losing any of my apps and data on Windows Subsystem for Android (WSA) -> [!IMPORTANT] -> Make sure that WSA has been turned off from the settings and that tools such has WSA-System-Control, WSA-Sideloader, WSAPacman etc are not running. +> [!IMPORTANT] +> Make sure that WSA has been turned off from the settings and that tools such has WSA-System-Control, WSA-Sideloader, WSAPacman etc are not running. 1. [Download the latest build](https://github.com/MustardChef/WSABuilds#downloads) (that you want to update to) @@ -559,9 +557,9 @@   -> [!NOTE] -> -> If you want to preseve your data, make a backup of the `%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx` file. After uninstalling, copy the VHDX file back to the `%LOCALAPPDATA%\Package\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache` folder. For a more comprehensive and detailed guide, take a look at the **Backup and Restore section** in this README markdown +> [!NOTE] +> +> If you want to preseve your data, make a backup of the `%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\userdata.vhdx` file. After uninstalling, copy the VHDX file back to the `%LOCALAPPDATA%\Package\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache` folder. For a more comprehensive and detailed guide, take a look at the **Backup and Restore section** in this README markdown ### To remove WSA installed through WSABuild: @@ -603,8 +601,8 @@ In order to make a backup of your WSA data you must copy the ``Userdata.vhdx`` ( Before attempting to restore your backup, you must remove WSA if installed. Then before you run the ``Run.bat`` script (to reinstall WSA after removing it), you need to remove these lines from ``Install.ps1``, located in the your extracted WSA folder:   -> [!TIP] -> The Lines (as shown below) that you need to remove in ``Install.ps1`` may vary depending on the type of WSA Build that you are trying to install. +> [!TIP] +> The Lines (as shown below) that you need to remove in ``Install.ps1`` may vary depending on the type of WSA Build that you are trying to install. #### Android Settings: @@ -636,10 +634,10 @@ After removing the lines above, run the script. When the Powershell window states "Press any key to quit", at that time multiple dialouge boxes will open: -<-- --> +<-- --> -> [!IMPORTANT] -> ****Ignore these and do not click on anything or close these popups**** +> [!IMPORTANT] +> ****Ignore these and do not click on anything or close these popups**** Go to ``%localappdata%\Packages`` and (if these folders/directory do not exist, create them) in ``MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalCache\`` paste the userdata.vhdx @@ -669,7 +667,7 @@ Now close the popups and run WSA and your userdata should hopefully be restored ``` or -- Location in Windows --->
`%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat` +- Location in Windows --->
`%LOCALAPPDATA%\Packages\MicrosoftCorporationII.WindowsSubsystemForAndroid_8wekyb3d8bbwe\LocalState\diagnostics\logcat` **Can I delete the installed folder?** @@ -697,7 +695,7 @@ Now close the popups and run WSA and your userdata should hopefully be restored **I cannot adb connect localhost:58526** -- Make sure developer mode is enabled. If the issue persists, check the IP address of Windows Subsystem For Android™ on the Settings ---> Developer page and try +- Make sure developer mode is enabled. If the issue persists, check the IP address of Windows Subsystem For Android™ on the Settings ---> Developer page and try ``` adb connect ip:5555 @@ -1111,10 +1109,10 @@ wsa://com.apple.android.music | TikTok (Global) | 25.0.3 | 12, 11 | ✅ | TikTok (TV Version) | 1.6.0 | 11 | ❌ | App crashes | TikTok Lite | 21.7.1 | 11 | ❌ | App crashes -| Tivimate | 4.4.0 | 11 | ✅ | Compatibility Options ->Force App to be non-resizeable ; Disable smooth resize ; Keyboard Compatibility ; ForceFullScreen [F11] Note: Version 4.5. And above force crashes, the latest working version remains 4.4.0 +| Tivimate | 4.4.0 | 11 | ✅ | Compatibility Options ->Force App to be non-resizeable ; Disable smooth resize ; Keyboard Compatibility ; ForceFullScreen [F11] Note: Version 4.5. And above force crashes, the latest working version remains 4.4.0 | TP-Link Tapo | 2.4.25 | 11 | ✅ | Trello | 2021.14.1.16332-production | 11 | ⚠️ | Login needs web browser installed in WSA, using Windows' default browser will not work -| Trust: Crypto & Bitcoin Wallet | 6.57.1 | 12 | ✅ || For login, you have to go to Android settings =>System =>Date & Time and toggle the "Set Time Automatically" option. you can access it by this command .\adb.exe shell "am start -n com.android.settings/.Settings" +| Trust: Crypto & Bitcoin Wallet | 6.57.1 | 12 | ✅ || For login, you have to go to Android settings =>System =>Date & Time and toggle the "Set Time Automatically" option. you can access it by this command .\adb.exe shell "am start -n com.android.settings/.Settings" | Tune In Pro | 28.7 (267721) | 11 | ✅ | Twitter | 9.16.1-release.00 | 11 | ✅ | Optionally requires GMS | Twitter Lite | 3.1.1 | 12 | ✅ || @@ -1446,8 +1444,8 @@ wsa://com.apple.android.music

If you can't find the build that you are looking for, I will be happy to fufill any custom build requests.

Open an issue in the [Issues page](https://github.com/MustardChef/WSABuilds/issues) with the information below.

-> [!IMPORTANT] -> - State the [Device Model](https://github.com/WSABuilds/MagiskOnWSALocal#--custom-model) (Default: Pixel 5)?
- Root Solution (Magisk, KernelSU or none)?
- If you want a WSA build with Magisk, what [variant of magisk](https://github.com/WSABuilds/MagiskOnWSALocal#--magisk-ver) would you like?
- Would you like GApps (Google Play Store and Play Services (GMS))?
- Would you like to keep the Amazon Appstore? +> [!IMPORTANT] +> - State the [Device Model](https://github.com/WSABuilds/MagiskOnWSALocal#--custom-model) (Default: Pixel 5)?
- Root Solution (Magisk, KernelSU or none)?
- If you want a WSA build with Magisk, what [variant of magisk](https://github.com/WSABuilds/MagiskOnWSALocal#--magisk-ver) would you like?
- Would you like GApps (Google Play Store and Play Services (GMS))?
- Would you like to keep the Amazon Appstore?

@@ -1576,9 +1574,9 @@ wsa://com.apple.android.music
-> [!IMPORTANT] -> ***The repository is provided as a utility.*** ->***Android is a trademark of Google LLC. Windows™ and Windows Subsystem for Android™ are trademarks of Microsoft LLC.*** +> [!IMPORTANT] +> ***The repository is provided as a utility.*** +>***Android is a trademark of Google LLC. Windows™ and Windows Subsystem for Android™ are trademarks of Microsoft LLC.*** @@ -1596,4 +1594,4 @@ wsa://com.apple.android.music - ##### Images from Icons8.com are licensed under the Icons8 License. - ([License](https://intercom.help/icons8-7fb7577e8170/en/articles/5534926-universal-multimedia-license-agreement-for-icons8)) -Please read the following Licenses in full before copy, modifiying, adapting and forking any of the content, code, images, videos and information from this GitHub repository. +Please read the following Licenses in full before copy, modifiying, adapting and forking any of the content, code, images, videos and/or information from this GitHub repository. \ No newline at end of file
Current Version:2311.40000.4.02311.40000.5.0 2311.40000.5.0
Release Date:15/12/202310/01/2024 10/01/2024

win11x64downpre

win11x64downpre

win11arm64downpre

win11arm64downpre

win11x64downstable

win10x64down

win10x64down

GPU

Any compatible Intel, AMD or Nvidia GPU.
GPU Performance may vary depending on its compatibility with Windows Subsystem For Android™

Users with Intel HD Graphics 530 and older


WSA may not start or graphical glitches will occur when Intel HD Graphics 530 and Older iGPUs are used. This is a known issue, but unfortunately there are no fixes that I currently know of, plus, these GPUs are too old and do not meet Windows 11 requirements and hence are not official supported. Follow this guide to switch to another iGPU/dGPU/eGPU that you may have or Microsoft Basic Renderer

Users with Nvidia GPUs


Nvidia GPUs are known to cause problems. If Windows Subsystem For Android™ does not start or there are graphical glitches when an Nvidia GPU is used, follow this guide to switch to another iGPU/dGPU/eGPU that you may have or Microsoft Basic Renderer
Any compatible Intel, AMD or Nvidia GPU.
GPU Performance may vary depending on its compatibility with Windows Subsystem For Android™

Users with Intel HD Graphics 530 and older


WSA may not start or graphical glitches will occur when Intel HD Graphics 530 and Older iGPUs are used. This is a known issue, but unfortunately there are no fixes that I currently know of, plus, these GPUs are too old and do not meet Windows 11 requirements and hence are not official supported. Follow this guide to switch to another iGPU/dGPU/eGPU that you may have or Microsoft Basic Renderer

Users with Nvidia GPUs


Nvidia GPUs are known to cause problems. If Windows Subsystem For Android™ does not start or there are graphical glitches when an Nvidia GPU is used, follow this guide to switch to another iGPU/dGPU/eGPU that you may have or Microsoft Basic Renderer

Storage