Desktop Screenshot Logger 🖥️

A desktop application for capturing screenshots from any window, including Android emulators. Perfect for UI testing workflows where you need to capture screens from applications outside the browser.

Features

• 📷 Capture Any Window - Capture screenshots from any application, including Android emulators
• 🖥️ Full Screen Capture - Capture the entire screen with one click
• ✂️ Region Capture - Select and capture a specific area of the screen
• 📑 Multiple Sheets - Organize screenshots into separate sheets (like Excel tabs)
• 📝 Add Notes - Document observations for each screenshot
• 📊 Excel Export - Export to .xlsx with embedded images
• 🌐 HTML Export - Generate beautiful HTML reports
• 📌 Always on Top - Keep the app visible while testing
• ⌨️ Keyboard Shortcuts - Quick capture with Cmd/Ctrl + Shift + S, Region with Cmd/Ctrl + Shift + R
• 🎨 Dark Blue Corporate Theme - Matches the Chrome extension design

Installation

Prerequisites

• Node.js (v16 or higher)
• npm (v8 or higher)

Setup

1. Navigate to the project folder:

   cd /path/to/DesktopScreenshotTool

2. Install dependencies:

   npm install

3. Run the application:

   npm start

Building for Distribution

To create a standalone executable:

# For macOS
npm run build:mac

# For Windows
npm run build:win

# For Linux
npm run build:linux

The built application will be in the dist folder.

Usage

Starting a Session

1. Launch the application
2. Enter an Excel File Name (e.g., Android_Test_Report)
3. Enter a First Sheet Name (e.g., Login_Flow)
4. Click 🚀 Start Session

Capturing Screenshots

1. Select Capture Source:

   • Screen - Captures the entire screen
   • Window - Select a specific window (like Android Emulator)

2. Capture:

   • Click the 📷 Capture Screenshot button
   • Or use the keyboard shortcut: Cmd/Ctrl + Shift + S

3. Add Notes:

   • Click 📝 Note to add observations to the last screenshot

Managing Sheets

• Click the ➕ button next to the sheet dropdown to create new sheets
• Switch between sheets using the dropdown
• Each sheet maintains its own set of screenshots

Exporting Reports

1. Select the export format:

   • Excel (.xlsx) - For team sharing and archiving
   • HTML Report - For quick viewing in browser

2. Click ⬇️ Download

3. Choose the save location

Minimal View

• Click ➖ in the header to switch to minimal view
• Perfect for quick captures while testing
• Click Expand to return to full view

Always on Top

• Click the 📌 button to toggle "always on top" mode
• Keeps the app visible while you work in other applications

Keyboard Shortcuts

| Shortcut | Action | |----------|--------| | Cmd/Ctrl + Shift + S | Capture full screen/window | | Cmd/Ctrl + Shift + R | Region capture (select area) |

Use Cases

Android Emulator Testing

1. Start Android Studio and launch the emulator
2. Open Desktop Screenshot Logger
3. Select "Window" as capture source
4. Choose the Android Emulator from the dropdown
5. Capture screenshots as you test

Desktop Application Testing

1. Open the application you want to test
2. Use "Screen" capture for full context
3. Or use "Window" capture for specific apps

Project Structure

DesktopScreenshotTool/
├── package.json
├── README.md
├── assets/
│   └── icon.png
└── src/
    ├── main.js          # Electron main process
    ├── index.html       # UI structure
    ├── styles.css       # Styling (dark blue theme)
    ├── renderer.js      # UI logic & state management
    └── jszip.min.js     # Excel export library

Comparison with Chrome Extension

| Feature | Chrome Extension | Desktop App | |---------|-----------------|-------------| | Web page capture | ✅ | ✅ | | Android emulator capture | ❌ | ✅ | | Any window capture | ❌ | ✅ | | Multiple sheets | ✅ | ✅ | | Notes | ✅ | ✅ | | Excel export | ✅ | ✅ | | HTML export | ✅ | ✅ | | Always on top | ❌ | ✅ | | Global shortcuts | ❌ | ✅ |

Troubleshooting

"Screen recording permission required" (macOS)

1. Go to System Preferences → Security & Privacy → Privacy
2. Select "Screen Recording" from the left panel
3. Add the Desktop Screenshot Logger app

Window capture not working

1. Ensure the target window is visible (not minimized)
2. Click the 🔄 button to refresh the window list
3. Try using "Screen" capture as an alternative

Screenshots are blank

• On macOS, grant screen recording permission
• On Windows, run as administrator if needed

License

MIT License - Walmart UI Testing Team

Version: 1.0.0 Theme: Dark Blue Corporate Companion to: Chrome Extension Screenshot Logger