Code Monkey home page Code Monkey logo

wsa-sideloader's Introduction

GitHub release (latest by date) GitHub all releases Python GitHub

WSA Sideloader

WSA Sideloader is a tool that is used to easily install APK files on Windows Subsystem for Android. The program has been designed with simplicity and ease of use in mind.

You can also install XAPK, APKM and APKS files using this tool.

image

Stay updated on the latest WSA Sideloader updates via the WhatsApp and Telegram channels.

Download

Operating System Source


ko-fi

Getting started

Make sure you have Windows Subsystem for Android installed on your machine. If you don't already have it, download it from here.

If you're not in a supported country, change your PC region setting to United States, you should then be able to download Amazon Appstore which contains the subsystem. You can change it back once you have installed it.

Windows 10 users: You can obtain community builds of WSA for Windows 10 from repositories like WSABuilds and WSAPatch. Please note that the MS Store version of WSA Sideloader is not available on Windows 10. You can install it from the releases page.

image

Enable developer mode in WSA settings. The subsystem will need to be running in order to install apps, however WSA Sideloader will attempt to start the subsystem for you if it's not running.

image

Choose the file you want to install and click the Install button. You can also install a file right from File Explorer, web browsers and other supported programs. You may need to authorize the ADB connection when using it for the first time.

You might see the below message if using WSA Sideloader for the first time. Just tick the box to always allow, allow the connection and run the installation again.

image

Known issues

APK installation failure in partially running mode

Microsoft has recently introduced a new partially running mode to WSA, and due to the way it works WSA Sideloader is not able to properly detect its running state and will show a "device offline" error should WSA enter its inactive state.

For now, you can open any app to wake up the subsystem before running WSA Sideloader. I hope to address this issue in a future update. Thank you for your patience.

FAQ

The APK installation fails with the error message "No connection could be made because the target machine actively refused it"

This is a bug with the subsystem itself, restarting the PC will usually fix it.

If you still get this error, try these steps:

  1. Make sure WSA is turned off and disable WSA autostart in Task Manager, startup apps before proceeding with the below steps

  2. Disable Hyper-V using the command dism.exe /Online /Disable-Feature:Microsoft-Hyper-V and reboot your PC

  3. Reserve port 58526 so Hyper-V doesn't reserve it back using the command netsh int ipv4 add excludedportrange protocol=tcp startport=58526 numberofports=1

  4. Re-enable Hyper-V using the command dism.exe /Online /Enable-Feature:Microsoft-Hyper-V /All and reboot your PC

I installed the app successfully, but the app crashes while using it or doesn't work as intended.

WSA Sideloader is just an APK installer. Whether the app actually works or not depends on the app and the subsystem. Please be aware that apps that require Google Play Services may not work properly on WSA. You may try solutions such as Magisk on WSA if you want Google Play functionality.

You may check this page for a list of compatible apps.

What's the difference between downloading from GitHub and downloading from MS Store?

The Microsoft Store version is packaged as MSIX, allowing for clean installs/uninstalls as well as autoupdates. If you download the EXE installer from GitHub instead, you will have the option to install for yourself or for all users of the computer. The version that is in the winget package repository is the GitHub version.

It is recommended you download from Microsoft Store to ensure you get the latest features and bug fixes. Please note that the MS Store version is not available on Windows 10.

Does Windows Subsystem for Android and WSA Sideloader work on my Windows VM running on my Apple Silicon Mac?

Due to lack of nested virtualization, running WSA on these systems is currently not possible.

I would like to see [feature name] in your program. When can you implement it?

I am no longer accepting feature requests. Please see this post for more information.

Bug reports will continue to be accepted.

Where can I see a list of installed WSA apps?

You can press the "Installed apps" button to bring up a list of apps installed on the WSA. You can launch and uninstall apps through it as well as manage notifications, permissions etc. for each app. WSA apps are also present on the start menu and you can right click to uninstall just like any other Windows program.

If you would like to launch a list of installed apps right from the start menu, I have made an app for that. You can download it here.

How do I help translate WSA Sideloader into my language?

Thank you for your help! You may refer to this readme for further details.

What are some good places to download APK files from?

APKMirror and APKPure are two popular sites for downloading APK files.

Support

Need help using WSA Sideloader? Post in the project's discussions tab. Found a bug? Visit the issues page.

Build Instructions

To compile from source, follow the below instructions:

  1. Install Git if you haven't already. Then clone the repo using the command git clone https://github.com/infinitepower18/WSA-Sideloader
  2. Download the latest version of Python 3.11 64 bit. If you are compiling for ARM64, install the ARM64 version of Python 3.11 instead.
  3. Install Nuitka via pip using the command pip install nuitka.
  4. Install the required dependencies for WSA Sideloader using the command pip install -r requirements.txt in the root directory.
  5. In the root directory run the command nuitka --standalone sideloader.py --enable-plugin=tk-inter --windows-disable-console --windows-company-name=infinitepower18 --windows-product-name="WSA Sideloader" --windows-icon-from-ico=icon.ico --windows-product-version=<version> --windows-file-version=<version> --windows-file-description="WSA Sideloader". (replace <version> with the current version number) This may take some time depending on your computer.
  6. Copy the icon.ico, apk.ico, aapt.exe files as well as the locales and platform-tools folders to the sideloader.dist folder.

Privacy Policy

Please click here to view the privacy policy.

TLDR - No information is collected by this application.

Disclaimer

This project is not affiliated with Microsoft or Google in any way.

wsa-sideloader's People

Contributors

dependabot[bot] avatar gidano avatar infinitepower18 avatar mesterperfect avatar s1204it avatar thomasgithubcom avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

wsa-sideloader's Issues

[UNINSTALLATION]Cannot uninstall WSA Sideloader from Microsoft Store.

Describe the bug

I want to uninstall wsa sideloader that i installed from microsoft store but i couldn't find the uninstall button!
Can anyone help me?

Steps to reproduce

Not sure what this means.

Expected behavior

Uninstalling

Download source

Microsoft Store

WSA version

2309.40000.10.0

WSA Sideloader version

1.4.4

Windows build number

22623.1250

Additional context

No response

[REQUEST]accessibility with screen readers

Describe your request

Good morning
Unfortunately, blind users cannot use this tool
Because the tool does not support accessibility with screen readers
The graphical interface of the tool is designed with PySimpleGUI
This library does not provide any accessibility support with screen readers
Can you create another version of the GUI based on wxpython
It offers full accessibility support with screen readers
Thanks

[REQUEST] Sideload files

Describe your request

Integrate 'adb push' to allow easy side-loading files or anything in addition to apk's with option to select the specific location of WSA

UI redesign

Redesign the program with Windows 11 style UI. May use something like CustomTkinter to help implement a new UI replacing the current PySimpleGUI implementation.

Native ARM build

Python 3.11 will be releasing later this year and they have started including installers and embeddable packages for Windows ARM64. I've been thinking of offering a native ARM build of WSA Sideloader. Most likely I will offer it as an experimental, available only via GitHub releases. And I'll see from there how it works out before making it official and offering it on MS Store as well.

I don't have a Windows ARM device so not sure yet how I'll be able to manage. Let me know your thoughts.

[BUG] Device offline

Describe the bug

When opening WSA with Gapps, it is unable to connect to port 127.0.0.1:58526 and says adb.exe: device offline, while installing Nova Launcher that worked before this change.

Steps to reproduce

Follow WSAGAScript/README.md on GitHub, and install Nova Launcher 8.0.3 beta (arm64-v8a + arm-v7a) (Android 8.0+) from APKMirror. (first link)

Expected behaviour

It should've just installed it, but it outputted the following error:
Screenshot (4)

Download source

Microsoft Store

Application version

1.3.10

Windows build number

Windows 11 22H2 (22621.1105) (Home)

Additional context

I have WSL working and I have an x86_x64 Intel i5 processor, with GTX 1650 as GPU.

[BUG] IP address error

Describe the bug

when the app auto detects the ip, it isn't using the right one, instead of using the IP of the computer it should be using 127.0.number number or smth like that with the port, and the dev option in the subsystem app needs to be enabled rather than dev in system settings.

Steps to reproduce

simply trying to install something

Expected behavior

should work rather then refusing to connect (bc of wrong IP)

Download source

Microsoft Store

WSA version

from ms

WSA Sideloader version

should not matter, newest version

Windows build number

some beta of windows 11

Additional context

No response

[BUG] APK install failure due to & in filename

Describe the bug

Attempting to download and install IFTTT software to work on some home automation.
Platform: Windows 11
I have four other Android Apps with IOT devices controlling fine so this is app specific.

Figured I would make a posting to see if this helps. The output is a bit lighton debug / logs / enabling higher log level

Source for APK
https://m.apkpure.com/ifttt-automation-workflow/com.ifttt.ifttt/download?utm_content=1008

Error

Unable to install the application. Please check ...blah blah..

[Error Info]
Performing streamed install
operable program or batch file.

Questions:

  1. within WSA-Sideloader -> can we run this via Powershell and set / increase logging from build and container?
  2. Has anyone else tried IFTTT and can provide feedback on there experience

I perused the "developer options" such as Select Debug App but .. no Debug App set and no means to set.

Steps to reproduce

  1. Launch WSA Sideloader
  2. Select IFTTT - automation & workflow_4.38.3_Apkpure.apk
  3. Install
  4. Get error
  5. reach for coffee

Expected behavior

App loads.. move on to next yak in line to shave.

Download source

Microsoft Store

WSA version

2303.40000.5.0

WSA Sideloader version

Version 10.0.22000.556 (Windows 11)

Windows build number

22624.1690

Additional context

No response

Sideload folders/files

Describe your request

Integrate 'adb push' to allow easy side-loading of folders/files in addition to apk's.

Rework update checker

Current implementation is unsuitable for certain version numbers. To be reworked in the next update.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.