# Screenshot Saver

A simple, cross-platform screenshot tool with clipboard monitoring, optional annotations, and HTML export.

## Features

- **Clipboard monitoring** — automatically captures screenshots from Win+Shift+S (Snip & Sketch) or any image copied to clipboard
- **Annotations** — optionally add text notes to each screenshot
- **HTML export** — generates a single HTML document with all screenshots embedded (base64)
- **Low-CPU background mode** — reduces polling when minimized
- **Cross-platform** — works on Windows, macOS, and Linux
- **Hotkeys** — Ctrl+Shift+R to restore from background

## Installation

```bash
pip install screenshot-saver
```

## Usage

### Command line
```bash
screenshot-saver
```

### As a Python module
```bash
python -m screenshot_saver
```

### From Python code
```python
from screenshot_saver import SimpleScreenshotTool

app = SimpleScreenshotTool()
app.run()
```

## First Run

On the first run, the app will prompt you to choose:
1. A folder to save screenshot images
2. A location for the HTML document

These settings are saved and reused on subsequent runs.

**Default locations:**
- **Config:** `%APPDATA%/screenshot_saver/` (Windows) · `~/.config/screenshot_saver/` (Linux) · `~/Library/Application Support/screenshot_saver/` (macOS)
- **Screenshots:** `~/Pictures/ScreenshotSaver/`

## Requirements

- Python 3.8+
- `pillow` (for screen/clipboard capture)
- `pynput` (for global hotkey detection)
- `tkinter` (included with most Python installations)

## Build Standalone EXE (Windows)

```bash
pip install pyinstaller
pyinstaller --onefile --windowed --name ScreenshotSaver -m screenshot_saver
```

## License

MIT
