app-screenshots

Capture App Store & Play Store screenshots directly from your iOS simulators, Android emulators, and physical devices. Generate professional store-ready screenshots with device frames and AI marketing copy — all from the terminal.

Quick Start

npx app-screenshots

That's it. No install needed. Just run it and start capturing.

How It Works

1. Run the command — auto-detects all booted simulators and connected devices
2. Log in — sign in with your email (magic link, no password needed) or subscribe directly in the terminal
3. Guided setup — answer a few questions about your app (name, style, copy) — same flow as the web editor
4. Capture — screenshots saved locally, organized by screen name
5. Open the editor — your project is saved to Screenshots.art ready to finalize

Features

• Auto-detects iOS Simulators, Android Emulators, and physical devices
• Captures from multiple devices simultaneously
• Organizes screenshots by platform and device name
• Magic link login — type your email, click a link, terminal connects automatically
• Subscribe in the terminal — $2.99/week or $29.99 lifetime via Stripe checkout, no web UI needed
• Guided onboarding wizard — app name, style, AI copy, all from the terminal
• Watermarked local mode — use it without an account, subscribe to remove watermarks
• Everything syncs to Screenshots.art for final export

Full Workflow

$ npx app-screenshots

  app-screenshots v0.1.0
  ─────────────────────────────────────────
  Capture App Store & Play Store screenshots
  and generate pro store graphics — from the terminal.
  ─────────────────────────────────────────

? What would you like to do?
  ❯ Log in with email
    Subscribe — $2.99/week
    Lifetime access — $29.99
    Continue without account (watermarked)

  Enter your email: [email protected]
  ✓ Magic link sent! Check your email and click the link...
  ✓ Authenticated as [email protected] (Weekly, 10 credits)

? What would you like to do?
  ❯ New project (guided setup)
    Open existing project

  App name: My Weather App
  Short description: Beautiful weather forecasts with hourly detail

  ? Capture screenshots now?  Yes

  ✓ Found 2 devices
    1.  iPhone 16 Pro Max (iOS 18.2)
    2.  Pixel 8 Pro (Android 15)

  Screen name: home
    ✓ iPhone 16 Pro Max
    ✓ Pixel 8 Pro

? What would you like to do?
  ❯ Capture next screen
    Done — upload & open editor

  ✓ Uploading screenshots...
  ✓ Project saved — opening editor...
    https://screenshots.art/dashboard/screenshots?app=...

Authentication

No API keys. Sign in with your email — a magic link is sent and the terminal connects automatically when you click it.

New users can subscribe directly in the terminal via Stripe checkout ($2.99/week or $29.99 lifetime). After payment, a magic link is sent to your email and you're logged in automatically.

Output Structure

screenshots/
├── ios/
│   └── iPhone_16_Pro_Max/
│       ├── home.png
│       └── settings.png
└── android/
    └── Pixel_8_Pro/
        ├── home.png
        └── settings.png

Raw captures are saved locally. Your project is also synced to Screenshots.art where you can finalize device frames, export at all required sizes, and download for App Store Connect / Google Play Console.

Requirements

• Node.js 18+
• iOS: Xcode with Simulator (macOS only)
• Android: Android Studio with adb in PATH

License

MIT