Android Screen Capture

Overview

Native macOS app that mirrors an Android device screen using scrcpy with an integrated console for live app logs. Matches the iPhone screen capture experience with a unified interface.

When to Use

Invoke this skill when the user:

• Asks to "start Android screen capture"
• Wants to "see their Android screen"
• Wants to "mirror their Android device"
• Mentions viewing or displaying their Android device
• Says "show me my Android phone"

Prerequisites

• Android device connected via USB
• USB debugging enabled (Settings → System → Developer options → USB debugging)
• Developer Mode enabled (Settings → About Phone → tap Build number 7 times)
• Device authorized for debugging
• scrcpy installed: brew install scrcpy
• ADB installed: brew install android-platform-tools

Instructions

1. Navigate to screen capture directory:

   cd miso/platforms/android/development/screen-capture/imp
   

2. Run the screen capture app:

   ./android_screencap.sh
   

3. The app will:

   • Build automatically if needed
   • Detect your connected Android device
   • Launch scrcpy for screen mirroring
   • Show a toolbar with device info and console button

Features

• Integrated window: Toolbar at top with scrcpy below
• Console toggle: Green ">" button opens live log panel
• Click to resize: Click the window to toggle full/half size
• Draggable: Drag by toolbar, scrcpy follows
• Live logs: Console shows [APP] prefixed logs from your app via adb logcat

What to Tell the User

• A dark borderless window will appear with your Android screen
• Green ">" button in toolbar opens the console panel with live logs
• Click anywhere on the window to toggle between full and half size
• Drag the toolbar to move the window (scrcpy follows)
• Close window or Cmd+Q to quit

Keyboard Shortcuts (in scrcpy area)

• ⌘+f: Toggle fullscreen
• ⌘+r: Rotate screen
• ⌘+g: Resize to 1:1 (pixel-perfect)
• ⌘+c: Copy device clipboard to computer

Taking Screenshots

./screenshot.sh output_filename.png

Reading Logs (for Claude)

adb logcat -v brief -d | grep "\[APP\]" | tail -30

Common Issues

"Device not found":

• Check USB debugging enabled
• Accept authorization prompt on device
• Verify with: adb devices

scrcpy doesn't follow when dragging:

• Grant accessibility permissions in System Settings → Privacy & Security → Accessibility

scrcpy not installed:

• Install: brew install scrcpy

No logs in console:

• Ensure app uses Logger with [APP] prefix
• Check app is running on device

Files

• main.swift - Native macOS app source
• build.sh - Compiles the Swift app
• android_screencap.sh - Builds (if needed) and launches
• screenshot.sh - Captures device screenshot