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.

• 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.

export DEST="/wherever/you/want"
{ echo $PATH | grep "${DEST}" > /dev/null 2>&1 && echo "Good to go!"; } \
  || echo "Not that one."

sudo curl -fL https://raw.githubusercontent.com/draumaz/aal/refs/heads/main/aal.sh > "${DEST}/aal"
sudo chmod -v +x "${DEST}/aal"
unset DEST

• If you want an xdg-desktop entry, run these commands.

# These are just example variables for a Fitbit launcher. Replace it with whatever is needed for your app.
export \
  WINTITLE="Fitbit" \
  TITLE="fitbit" \
  APP_ID="com.fitbit.FitbitMobile" \
  COMMENT="Fitbit (scrcpy wrapper, via aal)" \
  DEVICE_PIN="1234" # could you imagine? \
  ME="draumaz"

cat >> "${ME}-${TITLE}.desktop" << EOF
[Desktop Entry]
Type=Application
Name=${WINTITLE}
Comment=${COMMENT}
Exec=bash -c 'APP_ID="${APP_ID}" TITLE="${WINTITLE}" WINTITLE="${WINTITLE}" DEVICE_PIN="${DEVICE_PIN}" aal'
Icon=scrcpy
Terminal=False
Categories=Utilities
StartupNotify=false
EOF

xdg-desktop-menu install "${ME}-${TITLE}.desktop"
rm -fv "${ME}-${TITLE}.desktop"

unset WINTITLE TITLE APP_ID COMMENT DEVICE_PIN ME