adbsnap

v1.2.0

Published

10 days ago

Automated mobile screenshot capture, 4K vector device framing & App Store / Google Play asset studio

0High
0Medium
0Low

shriram_singh

adb android screenshot appstore google-play mockup device-frames sharp mobile-showcase cli

ADBSnap 📸

Automated Mobile Screenshot Capture, 4K Vector Device Framing & App Store / Google Play Asset Studio

Stop wrestling with manual Figma templates or low-res screenshot scripts. ADBSnap captures your live Android device or emulator directly into memory, wraps it into vector-sharp device bezels (iPhone 16 Pro, Pixel 9 Pro), lays down studio-grade gradient backdrops with auto-wrapped typography, and exports ready-to-upload store graphics in under a second.

🚀 What's New in v1.2.0

⚡ Zero-Dependency Native Studio Engine:
- Replaced heavy Next.js runtime with an ultra-lightweight, native Node HTTP server.
- Reduced runtime dependencies to only 3 (sharp, archiver, gifenc).
- Studio boots in < 15 milliseconds with zero Webpack compilation delay.
🪟 App Window Mode (Frameless Desktop App Experience):
- adbsnap studio now automatically launches in a dedicated desktop window without a browser address bar or tabs.
- Serves cleanly at http://adbsnap.localhost:3000.
💎 100% Pre-compiled Original Studio UI:
- Full React 19 visual dashboard with all Lucide icons, glassmorphism, filmstrip, and animations pre-compiled at build time.
🚀 Flawless npx Compatibility:
- Run npx adbsnap studio instantly from any directory with zero cache or loader issues.

🚀 What's New in v1.1.0

📶 Comprehensive Wireless ADB Suite:
- 1-Click USB ↔ Wi-Fi Switch: Automatically discover device IP, launch TCP/IP mode, and disconnect cables effortlessly.
- Android 11+ Pairing Modal: Built-in 6-digit wireless debugging pairing with port discovery and mDNS ZeroConf.
- Dynamic USB Auto-Prioritization: Automatically switches to lightning-fast USB mode the moment you plug a cable in, and falls back to Wi-Fi when unplugged.
- Interactive Transport Switcher: Instant 1-click toggle between [ 🔌 USB ▾ ] and [ 📶 Wi-Fi ▾ ] without disconnecting.
🖼️ "None (Raw Screenshot)" Canvas Theme:
- Export pristine, unedited 1:1 mobile screenshots with zero framing or backdrops.
- Automatically dims and disables headline and typography controls for a focused workflow.
🎬 Animated Story Maker:
- Turn multi-step screen flows into looping animated GIFs with customizable playback pace (500ms – 4000ms).
📱 Smart App Detection & Package Copier:
- Humanized active application badge (e.g. CoachConnect, Instagram, Chrome) with 1-click package name copying to clipboard.
📐 Expanded Device & Bezel Suite:
- Added Frameless Floating Mockup (frameless), iPad Pro 13", Android Tablet 11", iPhone 16 Pro, and Google Pixel 9 Pro.
- Verified 2026 App Store (6.9", 6.7", 6.5") and Google Play specifications.
🎨 Redesigned Studio Workspace:
- Space-optimized header, drag-and-drop external image upload, filmstrip reordering, and direct copy-to-clipboard (Ctrl+C).

⚡ Highlights

🚀 Zero-Config Instant Capture: Direct RAM streaming via ADB — no temporary device files left behind.
📱 4K Vector Bezels: Pixel-crisp iPhone 16 Pro (with Dynamic Island), Pixel 9 Pro, Tablets, and Frameless modes.
🎨 Curated Studio Backdrops: 8 presets (aurora, studioLight, sunset, midnight, freshMint, royal, cleanDark, none) or custom styles.
✍️ Smart Typography: Dynamic SVG headline and subtitle rendering with automatic text-wrapping and star rating badges.
📦 Multi-Store Asset Export: Generate all required App Store and Google Play sizes bundled into a single ZIP in one keystroke.
🤖 Hands-Free Tab Crawler: Automatically detect and crawl through bottom navigation tabs, capturing and framing each view hands-free.
🩺 Built-in Doctor: Diagnose ADB paths, device health, and USB authorization in seconds.
🖥️ Dual CLI Binary: Run as adbsnap or snapshot.

📦 Quick Start

Launch Interactive Web Studio (Recommended)

npx adbsnap studio

Opens the visual studio dashboard directly in dedicated App Window Mode at http://adbsnap.localhost:3000.

Run Instantly via `npx` (Headless Snap)

npx adbsnap snap

Or Install Globally

npm install -g adbsnap

🛠️ CLI Usage & Commands

adbsnap [command] [options]
# or
snapshot [command] [options]

1. `adbsnap snap` (Default)

Captures the active screen, frames it into a 4K showcase graphic, and saves it to ./output/.

# Quick capture with default aurora theme and iPhone 16 Pro bezel
adbsnap snap

# Custom title and subtitle
adbsnap snap --title "Track Your Daily Habits" --subtitle "Simple. Fast. Beautiful."

# Use Pixel 9 Pro bezel on sunset gradient
adbsnap snap --frame pixel-9-pro --theme sunset --title "Explore Destinations"

# Save unedited raw screenshot buffer
adbsnap snap --raw

2. `adbsnap export`

Batch-generates complete asset packs across Apple App Store and Google Play dimensions, packaged into a ready-to-upload ZIP file.

adbsnap export --theme studioLight --title "Workout Companion" --zip

3. `adbsnap crawl [package]`

Inspects your running Android app, auto-detects bottom navigation tabs (BottomNavigationView, TabLayout), and navigates through each tab capturing a complete framed showcase suite.

adbsnap crawl com.example.myapp --theme midnight

4. `adbsnap run [config.json]`

Executes an automated multi-step screenshot journey from a JSON configuration file.

adbsnap run adbsnap.config.json

5. `adbsnap journey`

Interactive CLI wizard that guides you through a multi-screen capture session with customizable titles for each step.

6. `adbsnap doctor`

Diagnoses your local Android development environment:

adbsnap doctor

  • Node.js Version : v20.12.0
  • Operating System: win32 (x64)
  • ADB Executable  : C:\Users\user\AppData\Local\Android\Sdk\platform-tools\adb.exe

  [USB] Pixel 8 Pro (1A2B3C4D) -> READY

7. `adbsnap devices`, `adbsnap wifi` & `adbsnap usb`

List all connected USB, Wi-Fi, and emulator devices, switch to wireless mode, or cleanly revert back to USB:

# List all attached devices and authorization health
adbsnap devices

# 1-Click switch attached USB device to wireless mode
adbsnap wifi

# Disconnect Wi-Fi mode and revert phone connection back to USB
adbsnap wifi off
# or alias:
adbsnap usb

8. `adbsnap studio`

Launches the full interactive visual web dashboard on http://localhost:3000:

Spacebar Hotkey: Pull fresh screens directly from phone to canvas instantly.
Wireless IP & Android 11+ Pairing: Connect and pair wirelessly from the header.
Filmstrip Reordering: Collect multiple screens across user flows, reorder tabs, or import computer images.
1-Click Clipboard Export: Copy mockups directly to clipboard for pasting into Figma, Slack, or Docs.
Animated Story Maker: Compile captured screens into looping animated GIFs.
4K Multi-Store ZIP Export: Download complete App Store & Google Play bundles in one click.

9. 💻 VS Code Extension

Use ADBSnap directly inside Visual Studio Code without leaving your editor:

Activity Bar Sidebar: Live connected devices tree with 1-click capture & recent gallery.
Shortcuts: Ctrl+Alt+S for instant 4K framed capture, Ctrl+Alt+C to copy directly to clipboard.
Visual Asset Studio: Embedded interactive preview tab with dynamic theme swatches and headline editing.
Install from the VS Code Marketplace or search "ADBSnap" in the Extensions tab (Ctrl+Shift+X).

⚙️ Options Reference

📋 JSON Automation Spec (`adbsnap.config.json`)

You can define repeatable, automated capture pipelines:

{
  "theme": "aurora",
  "frame": "iphone-16-pro",
  "layout": "appstore",
  "flow": [
    {
      "action": "launch",
      "package": "com.myapp.android"
    },
    {
      "action": "wait",
      "ms": 1000
    },
    {
      "action": "snap",
      "title": "Welcome Home",
      "subtitle": "Everything at a glance"
    },
    {
      "action": "tap",
      "selector": { "text": "Analytics" }
    },
    {
      "action": "snap",
      "title": "Realtime Stats",
      "subtitle": "Deep insights into your performance"
    }
  ]
}

📄 License

This project is licensed under the MIT License — free for personal and commercial use.

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

ADBSnap 📸

🚀 What's New in v1.2.0

🚀 What's New in v1.1.0

⚡ Highlights

📦 Quick Start

Launch Interactive Web Studio (Recommended)

Run Instantly via npx (Headless Snap)

Or Install Globally

🛠️ CLI Usage & Commands

1. adbsnap snap (Default)

2. adbsnap export

3. adbsnap crawl [package]

4. adbsnap run [config.json]

5. adbsnap journey

6. adbsnap doctor

7. adbsnap devices, adbsnap wifi & adbsnap usb

8. adbsnap studio