# Unity Screenshot Monitor

A brutal efficiency tool for monitoring Unity development with AI assistance. Takes periodic screenshots of your Unity editor and maintains only the most recent ones for AI analysis.

## Features

- 📸 **Automated Screenshot Capture** - Monitor your Unity editor at configurable intervals
- 🎯 **Multi-Monitor Support** - Select and preview specific monitors
- 💾 **Brutal Cleanup Mode** - Keeps only 2-3 recent screenshots, obliterates the rest
- 📝 **AI-Ready Structure** - Maintains a `session_summary.md` for AI to update
- ⏸️ **Pause/Resume** - Take breaks without capturing
- 🔥 **Smart Detection** - Skip identical frames to save space
- ⌨️ **Global Hotkey** - Ctrl+Shift+S to start/stop from anywhere

## Installation

1. **Install Python 3.7+** (if not already installed)

2. **Install required packages:**
```bash
pip install mss pillow keyboard
```

3. **Download the script** and save as `unity_screenshot_monitor.py`

## Usage

### Basic Setup

1. **Run the script:**
```bash
python unity_screenshot_monitor.py
```

2. **Select your Unity monitor:**
   - Click "Refresh" to detect all monitors
   - Select your Unity monitor from the dropdown
   - Check the preview to confirm it's the right one

3. **Choose base folder:**
   - Click "Choose Folder" 
   - Select where to save screenshot sessions

4. **Configure settings:**
   - **Interval**: How often to capture (default: 30 seconds)
   - **Screenshots to keep**: 2-3 recommended for AI efficiency
   - **Enable brutal cleanup**: Keeps folder clean (recommended)

5. **Start monitoring:**
   - Click "Start Monitoring" or press Ctrl+Shift+S
   - The tool will create a new session folder

### Folder Structure

```
YourBaseFolder/
└── session_20240113_143022_123/
    ├── metadata.json               # Session configuration
    ├── 00018_timestamp.png         # Rolling backup (last 20)
    ├── 00019_timestamp.png
    └── ai_context/                 # AI-optimized folder
        ├── session_summary.md      # Living AI summary
        ├── 00238_timestamp.png     # Most recent screenshots
        ├── 00239_timestamp.png     # (only 2-3 kept)
        └── 00240_timestamp.png
```

### Working with AI

1. **Point your AI to the `ai_context` folder**
   
2. **Example AI prompt:**
```
Look at the screenshots in the ai_context folder and the session_summary.md file. 
Update the summary with:
- Current Unity scene/state
- Notable changes since last update  
- Any errors or issues visible
- Progress on current task

Keep the summary concise but comprehensive.
```

3. **The AI will see:**
   - 2-3 most recent screenshots
   - The evolving session summary
   - Nothing else to slow it down

### Controls

- **Start/Stop**: Button or Ctrl+Shift+S
- **Pause/Resume**: Pause button (when running)
- **Manual Stop**: After 2 hours auto-stops

### Advanced Settings

- **Similarity Threshold**: How similar frames must be to skip (0.95 = 95% similar)
- **Compress PNGs**: Reduces file size by 50-70%
- **Skip unchanged frames**: Avoids capturing identical screens

## Tips for Unity Development

1. **Position Unity on your second monitor** consistently
2. **Keep Unity maximized** for consistent captures
3. **Use windowed mode** instead of fullscreen for better capture
4. **Close overlapping windows** that might block Unity

## Troubleshooting

**"Second monitor not detected"**
- Make sure your second monitor is active
- Try clicking "Refresh" monitors
- Check Windows display settings

**Screenshots are black**
- Some fullscreen applications can't be captured
- Try windowed or borderless windowed mode
- Check if Unity is using exclusive fullscreen

**"Access denied" errors**
- Run as administrator on Windows
- Make sure the chosen folder has write permissions

**AI can't access screenshots**
- Ensure file paths are accessible to your AI tool
- Use absolute paths when referencing the ai_context folder

## Memory/Storage Considerations

- Each PNG: ~1-5MB (depending on resolution)
- 2-hour session: ~240 screenshots max
- Brutal mode keeps only: 3 in AI folder + 20 backup = ~115MB total
- Without brutal mode: Could exceed 1GB per session

## Privacy Note

This tool captures everything on your selected monitor. Be mindful of:
- Sensitive code or credentials
- Private messages or emails  
- Personal information

Consider pausing when handling sensitive content.

---

**Pro tip**: Your AI assistant can now watch you code without drowning in 240 identical screenshots of your loading screen. You're welcome! 🚀