Capture Screen Macos

⭐ ALWAYS START HERE when capturing specific windows to avoid errors.

List All Windows (Recommended): Returns a JSON array with all detected windows, including app name, window title, ID, bounds, and area.

python3 capture-screen-macos/window_info.py list

Example output:

[
  {
    "app": "Google Chrome",
    "title": "GitHub - example/repo",
    "id": 12345,
    "bounds": {"X": 0, "Y": 25, "Width": 1920, "Height": 1080},
    "area": 2073600
  },
  {
    "app": "Visual Studio Code",
    "title": "skill.md - oai-skills",
    "id": 67890,
    "bounds": {"X": 100, "Y": 100, "Width": 1200, "Height": 800},
    "area": 960000
  }
]

Get Active Window Info: Returns JSON with info about the currently active (frontmost) window.

python3 capture-screen-macos/window_info.py active

2. Take Screenshots

Full Screen Screenshot

Run the python script with the full command:

python3 capture-screen-macos/screenshot.py full <output_path>

Example:

python3 capture-screen-macos/screenshot.py full /tmp/my_screen.png

Window Screenshot

Run the python script with the window command, specifying the application name and output path.

⚠️ Important: Use the exact app name from window_info.py list output for best results. The script supports fuzzy matching (e.g. "Safari" matches "Safari浏览器"), but exact matches are more reliable.

python3 capture-screen-macos/screenshot.py window "<App Name>" <output_path>

Examples:

python3 capture-screen-macos/screenshot.py window "Google Chrome" /tmp/chrome_window.png
python3 capture-screen-macos/screenshot.py window "Safari" /tmp/safari_window.png
python3 capture-screen-macos/screenshot.py window "Visual Studio Code" /tmp/vscode_window.png

List Windows (Human Readable)

To see a formatted table of windows for quick reference:

python3 capture-screen-macos/screenshot.py list

Dependencies & Requirements

• macOS.
• Python 3.
• swift (installed by default on macOS) for low-level window queries.
• Permissions to control "System Events" (for active app detection).