How can I connect my "Android Terminal" extension to my Android phone?

First, connect your Android device to the computer with a USB cable. Then make sure the developer mode is enabled on your Android device. To enable developer mode, you'll need to access the Developer Options in the device settings. Here's how you can do it:

• Open Settings: Open the Settings app on your Android device. You can typically find it in your app drawer or by swiping down from the top of the screen and tapping the gear-shaped icon in the upper-right corner.
• About Phone: Scroll down in the Settings menu, and find the "About Phone" or "About Device" option. It might be under a sub-menu like "System" or "Software Information."
• Software Information: In the "About Phone" section, locate and tap on "Software Information."
• Build Number: Look for an option called "Build Number" or something similar. Tap on it repeatedly (usually about seven times) in quick succession. You'll typically see a message like "You are now a developer!" or "Developer mode has been enabled."
• Developer Options: Once you've unlocked Developer Options, you can find them in the main Settings menu. Go back to the main Settings screen and scroll down. You should now see "Developer Options" listed as one of the categories.
• Enable USB Debugging: Tap on "Developer Options" to access the menu. Scroll down and find "USB Debugging" option and enable it.

Now, click the action button in the browser toolbar area. You may find the icon within the "extensions" popup. A fresh "Terminal" window will appear. Select the "Open Terminal" option and grant permission for the extension to access the USB device. Next, inspect your Android phone to confirm the connection. Your Android device will display a public key's fingerprint associated with the extension. If you plan to use this tool frequently, select the "Remember this key" option and authorize the connection. The extension will launch a new terminal where you can confirm access by entering the "uname -a" command and pressing the Enter key.

If you require an additional terminal, use the keyboard shortcut Ctrl/Command + Shift + S. You can open as many terminals as necessary. To close a terminal, input "exit" and hit Enter. Any closed sessions will be automatically removed.

Supported keyword shortcuts

• Ctrl/Command + Shift + O: Open connection with Android device
• Ctrl/Command + Shift + S: Opens additional terminal panel (works when device is connected)
• Ctrl/Command + Shift + C: Take an screenshot of the current view (works when device is connected)
• Ctrl/Command + Shift + X Receive a file from Android storage to the default download directory of your browser (works when device is connected)
• Ctrl/Command + Shift + Z Send multiple files from your desktop to the Android storage (works when device is connected)

What's new in this version?

Please check the Logs section.

Is it safe to save the public key on my Android device?

By saving the public key generated by this extension when you initially connect it to your Android device, you can open terminals when your USB is connected without the need to reconfirm the communication each time. If you no longer require these keys, you can revoke all public keys within your Android developer menu.

The extension stores the generated public and private keys in the private IndexedDB storage. It's important to note that this storage will be deleted if you uninstall the extension from your browser. You will need to allow the new key after the first connection is established.

Can I send files to my Android device with this extension?

While the connection is live, you can transmit multiple files simultaneously. To accomplish this, press Ctrl/Command + Shift + Z to browse your files. Choose all the files you wish to send to your Android device, and then specify the destination path on the phone. The default directory for this is "/storage/emulated/0/Download/." The extension will provide progress updates on the file transfer within the notification area of the page.

Can I use this extension to take screenshot of the Android device directly in my Desktop computer?

During an active communication session, use the Ctrl/Command + Shift + C keyboard shortcut. The extension will capture a screenshot of the current display. If your Android device is locked, the screenshot will be taken from the lock screen. The image will be saved in PNG format in the default download directory of your browser.

How can I see the list of installed packages on my Android device?

To view a list of all installed packages on an Android device, you can use the pm (package manager) command in the terminal. Open a terminal or shell on your Android device, and then use the following command:

pm list packages

Can I use this extension to archive a package and its stored data into my desktop computer?

Yes, you can use this extension to archive a package and its stored data to your desktop computer. Here's how you can do it: Open a shell window on your Android device. Type the backup command with the appropriate options to create an archive of the package and its data. For example:

• Open a shell view on the extension.
• Type the backup command with the appropriate options to create an archive of the package and its data. For example:

  bu backup -apk -obb -shared -all -f /storage/emulated/0/backup.adb com.example.package

Replace "com.example.package" with the actual package name you want to archive.
• The archive will be saved to the specified location, which in this example is /storage/emulated/0/backup.adb.
• To transfer the stored "backup.adb" file to your desktop computer, you can use the extension's file transfer feature. You might use a shortcut, like Ctrl/Command + Shift + Z, to initiate the transfer. Then select the "backup.adb" file and specify a destination on your desktop computer.

Is it possible to back up packages for multiple users when the multiple profiles feature is enabled on a Pixel device?

You can use the "bu" command with the "-user" argument for backing up packages for different users. However, it's crucial to ensure that your Android device supports this feature. You can test this by opening multiple terminals, running "logcat" in one view, and then executing the "bu backup" command with the "-user" argument to check if any errors appear in the Android log view. Also, check "bu help" for more info about supported arguments.

When I try to connect to my phone I get "Failed to execute 'claimInterface' on 'USBDevice': Unable to claim interface." error. How can I fix it?

It means that you already have an active ADB server. run adb kill-server on a terminal to release the server.