aal

Android App Launcher, a scrcpy wrapper

• Open an app on your Android device and use it seamlessly on your PC, similar to Apple's iPhone Mirroring feature.
• Your device's screen will blacken during use.

Usage

• Device is unlocked: APP_ID="com.fitbit.FitbitMobile" sh aal.sh

• Device is asleep/locked: DEVICE_PIN="Your 4-6 digit pin" APP_ID="com.fitbit.FitbitMobile" sh aal.sh

  • aal will use dark magic to automate waking and unlocking your device.
  • An optional DEVICE_IP variable is available to automatically connect to your device if you're using the magisk-wifiadb module.

• As with vanilla scrcpy, you may replace the APP_ID package ID with a conventional name of the app prefixed with a question mark, such as APP_ID="?fitbit".

Demonstration

• It's fully interactive with keyboard and mouse.
• When you close aal, you will return to the previously open app. Otherwise, the device will go back to sleep.

Prerequisites

• Android phone with scrcpy installed and ADB debugging over Wifi enabled
• PC with scrcpy installed and an active wireless ADB debugging connection
  • Check: adb devices

Install

• aal is just a shell script; make it an executable and put it somewhere in your path.

Variable description

Required

• APP_ID: package name of app, e.g. "com.fitbit.FitbitMobile"
  • If you don't know the package name, open it on your device and run the following command.
  • adb shell dumpsys activity activities | grep ResumedActivity | awk '{print $4}' | tail -1 | sed 's|/|\n|g' | head -1

Optional

• DEVICE_IP: autoconnect to your device, e.g. "192.168.0.250:62112"
• DEVICE_PIN: automatically unlock your device with digit PIN, e.g. "1959"
• TITLE: window title, e.g. "Fitbit" (does not have to match APP_ID)