Claude-skill-registry android-screen-capture
Start Android screen mirroring using scrcpy. Displays device screen in real-time on Mac with optional console logs. Use when viewing Android screen, mirroring device, or monitoring app with logs.
install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/android-screen-capture" ~/.claude/skills/majiayu000-claude-skill-registry-android-screen-capture && rm -rf "$T"
manifest:
skills/data/android-screen-capture/SKILL.mdsource content
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
-
Navigate to screen capture directory:
cd miso/platforms/android/development/screen-capture/imp -
Run the screen capture app:
./android_screencap.sh -
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
prefixed logs from your app via[APP]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
prefix[APP] - Check app is running on device
Files
- Native macOS app sourcemain.swift
- Compiles the Swift appbuild.sh
- Builds (if needed) and launchesandroid_screencap.sh
- Captures device screenshotscreenshot.sh