iphone-screen-capture

Start the iPhone screen capture app to mirror a connected iPhone's screen on macOS. Use when the user wants to view their iPhone screen, mirror their device, or start screen capture.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill enables high-performance iPhone screen mirroring on macOS, providing developers with a native interface to view device screens, capture screenshots, and access live system logs. By integrating AVFoundation and pymobiledevice3, it streamlines the mobile development workflow, allowing for real-time debugging and visual monitoring of physical iOS devices directly from the desktop.

Use Cases

  • Mobile App Debugging: Stream live application logs and monitor runtime behavior on a physical iPhone to identify and fix bugs faster.
  • UI/UX Testing: Observe real-time user interactions and visual layouts on a physical device to ensure design fidelity and responsiveness.
  • Product Demonstrations: Mirror an iPhone screen during virtual meetings or presentations to showcase mobile app features with high clarity.
  • Technical Documentation: Capture high-quality device screenshots directly to the macOS filesystem for use in developer guides or bug reports.
  • Log Analysis: Use the integrated console to filter and analyze system logs via pymobiledevice3 without leaving the macOS environment.
nameiphone-screen-capture
descriptionStart the iPhone screen capture app to mirror a connected iPhone's screen on macOS. Use when the user wants to view their iPhone screen, mirror their device, or start screen capture.

iPhone Screen Capture

Overview

Native macOS app that mirrors a connected iPhone's screen on the Mac desktop using AVFoundation. Features an integrated console for live app logs via pymobiledevice3.

When to Use

Invoke this skill when the user:

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

Prerequisites

  • iPhone connected via USB
  • Device trusted (tap "Trust This Computer" on iPhone)
  • pymobiledevice3 installed for console logs (pip3 install pymobiledevice3)

Instructions

  1. Navigate to the screen capture directory:

    cd miso/platforms/ios/development/screen-capture/imp
    
  2. Run the screen capture script:

    ./iphone_screencap.sh
    

Features

  • Borderless window (390x844) styled like an iPhone
  • Console toggle: Click ">" button in top-right to open live log panel
  • Click to resize: Click window to toggle between full and half size
  • Draggable: Move window by clicking and dragging anywhere
  • Live logs: Console shows [APP] prefixed logs via pymobiledevice3 syslog

What to Tell the User

  • A borderless window will appear showing their iPhone screen
  • Click the ">" button to open the console panel with live logs
  • Click anywhere on the window to toggle full/half size
  • Close window or Cmd+Q to quit

Taking Screenshots

./screenshot.sh /tmp/screenshot.png

Reading Logs (for Claude)

When console is open, logs stream via pymobiledevice3. Claude can also read logs with:

pymobiledevice3 syslog live 2>/dev/null | grep "\[APP\]" | head -20

Troubleshooting

iPhone screen not showing:

  • Check USB connection
  • Ensure iPhone is unlocked
  • Accept "Trust This Computer" prompt
  • Disconnect and reconnect device

Console not working:

  • Install pymobiledevice3: pip3 install pymobiledevice3
  • Check device is trusted

Files

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