anthonygress / android-toolkit

A cross platform desktop app written in Typescript/Node using React and Electron. Android-Toolkit is a GUI for adb and can be used to modify android devices such as phones, firesticks and google TVs.

Android-Toolkit

Install

Mac & Linux

Copy and paste this into the Terminal App to install.

/bin/bash -c "$(curl -sL https://raw.githubusercontent.com/AnthonyGress/Android-Toolkit/main/install.sh)"

---

Windows

Download Latest: Release

Use the latest released installer named Android-Toolkit-Setup.exe to get started.

Usage

Android TV / FireTV

1. Make sure you are on the same WiFi network as your android device.
2. Find the IP address of your device.
   On FireTV: Firestick Settings > My Fire TV > About > Network
3. Go to Device Settings and turn on ADB debugging and Install Apps from Unknown Sources.
   On FireTV: Settings > My Fire TV > Developer Options
4. Enter IP address into ADB Connection Tools and click "Connect" or press the enter key.

Phones/Tablets with Android 11 or higher

For wired adb connection, you will need to:

1. enable developer mode by tapping on the build number in the about settings
2. enable usb debugging.
3. plug in your device via usb

For wireless connection you will need to:

1. enable developer mode
2. enable usb debugging
3. wireless debugging.
4. Under the wireless debugging settings, you will need to tap pair device with pairing code.
5. Enter the pairing ipAddress:port and the pairing code in Android Toolkit.
6. Once paired, you will need to back out and use the ADB Connect section to connect to the IP address and port listed under wireless debugging.

To enable file transfer with your connected computer:

1. Plug your device in via USB
2. Tap to notification on your phone/tablet that says "charging via USB"
3. Choose the option for File transfer / Android Auto.

APK Tools

Install Single APK

You can install any APK file from your computer directly on to your android device.

Batch Install

Installs ALL files with .apk extension in the selected directory onto your device.

Quick Install Apps

One click install for selected popular modded apps.

TV Apps

SmartTube - https://github.com/yuliskov/SmartTubeNext/blob/master/README.md

Launcher Manager (FireTV) - https://forum.xda-developers.com/t/app-firetv-noroot-launcher-manager-change-launcher-without-root.4176349/

Wolf Launcher - https://www.techdoctoruk.com/tutorials/block-android-tv-adverts-with-wolf-launcher/

Mobile Apps (phone/tables)

Note: Delete the original play store app before installing

Revanced - https://revanced.app/

To learn more about what each patch does, open the ReVanced Manager app and select your application, or visit the website for ReVanced Patches

The Infinity for Reddit patch is from https://github.com/KhoalaS/Infinity-For-Reddit

Simply click the button to download and install the app directly on your device.

For spotify/reddit you may need to login with your username and password if signing in with google doesn't work. Youtube and Youtube Music need MicroG installed to login to your google account.

ReVanced Tools

Download each of the apps in the list. Then open ReVanced and patch your youtube app. To revert at any time, simply uninstall the app and use the original youtube app from the play store.

You can get links to open in the ReVanced app by going into settings > apps > youtube > open by default and unchecking all the options. Then delete data, disable/delete the app, then restart.

To enable links to open in Youtube ReVanced, go to settings > apps > Youtube ReVanced > open by default and select all the options, then restart.

NOTE: On my pixel device it seems any youtube links from google chrome will try to open in the stock youtube app, or take you to the play store to install/enable it. This doesn't seem to happen from the google app.

Prebuilt apks - Revanced APKs

FireTV Tools

Set Screensaver

Lets you set a custom screensaver app. I have included a modified application in this repo called "Website Daydream" that changes the default wallpaper to the website https://clients3.google.com/cast/chromecast/home

After installing Website Daydream, install the application called Activity launcher (https://www.f-droid.org/en/packages/de.szalkowski.activitylauncher/). Open it, and just touch the website daydream app in order for it to work.

Check Screensaver

Gets the current values for your screensaver and returns them.

Debloat

Disables ALL unnecessary Amazon services that are not needed (may break some amazon services)

System Tools

Each action is performed on the connected android device with the exception of the Terminal action. This opens the terminal on your local computer in the platform-tools folder where you can directly run ADB commands.

Ex. ./adb install test.apk

For Battery Remaining, just divide the number by 1000 to get your battery status in mAh.

You can learn more about ADB commands at https://developer.android.com/tools/adb

Debugging

If your device is showing connected but says offline when you list devices or you cannot perform some actions, simply turn off ADB debugging on your device and re-enable it. Then reconnect using the app and it should work again.

android-toolkit's Issues

Feature: Remember last connected IP

For quick reconnection

Add tests

Install Issue

Prerequisites

• Windows 10

Expected Behavior

• For the app to install fully

Current Behavior

• I installed the app on the newest version and it always just makes a Uninstall file here
  
  and the shortcut that it makes leads to no where
• I then installed a previous version of the app which downloaded and opened using the shortcut but it never downloaded any adb stuff and when I manually put it in it still couldn't use it
• I then tried to update the old version which then it kept trying to access a folder that didn't exist

Steps to Reproduce

• Explained in the Current Behavior

Possible Solution (Not obligatory)

• I feel like the problem is to do with me changing my main user account from 44752 to Jay since in the file system it is still under 44752.

Context

I was trying to install the app

Your Environment

• App version : Newest
• Device (Phone, FireTV, AndroidTV) and Android version : Fire Stick FireOS 9

Windows 10 - Shell not working - Error: Command failed: open -a Terminal 'open' is not recognized as an internal or external command

Prerequisites

Expected Behavior

Terminal window open for code input

Current Behavior

Error: Command failed: open -a Terminal
'open' is not recognized as an internal or external command

Steps to Reproduce

1. Connect to device - working

2. Click on 'Shell' - error is produced4.

Possible Solution (Not obligatory)

Context

Unable to send commands via shell to the device

Your Environment

• Node version : ???
• App version : 1.4.1
• Operating System and version : Windows 10 Pro
• Link to your project : Na

Feature - Sticky terminal window

Having a terminal window that is visible when scrolling down to view the other options would be amazing :)

Request - Batch install/sideload .apks

Would be great if we could select more that one .apk and sideload them in a que :)

Feature - Loading/progress bar

On Windows currently there is no live view or indication that the click has been registered (loading bar/live view etc)

Feature: adb push/pull

Allows getting/setting files on the android device

Windows 10 - $Error: Command failed: The system cannot find the path specified.\r

Prerequisites

Expected Behavior

The connection should be successful/a a prompt come up on the fireTV stick to allow debugging from the connection

Current Behavior

$Error: Command failed: %appdata%\Android-Toolkit\platform-tools\adb connect 192.168.0.107
The system cannot find the path specified.\r

Steps to Reproduce

1. Scan the IP range for the FireTV stick

2.Fails

Possible Solution (Not obligatory)

Context

Unable to connect to FireTV stick to test pushing .APKS and the tools that are built in

Your Environment

• Node version : ???
• App version : 1.3.8
• Operating System and version : Windows 10 Pro
• Link to your project : Na

Automated tools - LauncherHijack

Would be great if you could link a automated button for some of the other GitHub projects out there such as LauncherHijack

Software auto-update/update button

Hi,
A auto update feature or a update link to the GitHub page etc in the help menu would be awesome :)