snapexcel 1.0.0

package/README.md

@@ -0,0 +1,182 @@
+# 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:**
+   ```bash
+   cd /path/to/DesktopScreenshotTool
+   ```
+
+2. **Install dependencies:**
+   ```bash
+   npm install
+   ```
+
+3. **Run the application:**
+   ```bash
+   npm start
+   ```
+
+### Building for Distribution
+
+To create a standalone executable:
+
+```bash
+# 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