android-screen-capture

The android-screen-capture skill provides a streamlined interface for developers and QA engineers to mirror an Android device screen directly to a macOS environment. By leveraging the high-performance scrcpy tool, this skill creates a borderless, interactive window that reflects the device's screen in real-time. It is designed to bridge the gap between physical hardware and desktop development workflows, offering a seamless experience for monitoring application behavior, debugging UI layouts, and testing user interactions.

Beyond simple mirroring, this agent includes a custom integrated console feature. By clicking the green button in the toolbar, users can access a live log panel that captures app-specific events using adb logcat. This allows developers to correlate visual screen changes with background system logs instantly, significantly reducing context switching during the debugging process. The tool is highly configurable, supporting shortcuts for rotation, resizing, and clipboard synchronization, making it a robust companion for mobile development tasks.

• Real-time Android screen mirroring via scrcpy with minimal latency.

• Integrated live console for viewing application logs filtered by custom prefixes.

• Desktop-native window controls, including draggable toolbars and click-to-resize functionality.

• Support for advanced shortcuts: ⌘+f for fullscreen, ⌘+r for screen rotation, ⌘+g for pixel-perfect scaling, and ⌘+c for clipboard sharing.

• Native screenshot capability to capture device state for documentation or bug reports.

• Unified macOS interface that simplifies the standard scrcpy command-line experience.

• Ensure Android device has USB debugging and Developer Mode enabled before invocation.

• Requires local installation of scrcpy and Android platform-tools via Homebrew.

• Use the provided shell scripts (android_screencap.sh, screenshot.sh) for consistent execution.

• Logcat functionality relies on the application emitting logs with an [APP] prefix for optimized filtering.

• If mirroring fails to follow window movement, grant accessibility permissions in System Settings.

• Compatible with any USB-connected Android device authorized through ADB.