Metadata-Version: 2.4
Name: screenshot-saver
Version: 1.0.0
Summary: Simple cross-platform screenshot tool with clipboard monitoring, annotations, and HTML export.
Author-email: Anupam shaw <anupamshaw6471@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/anupamshaw6471/screenshot-saver
Project-URL: Repository, https://github.com/anupamshaw6471/screenshot-saver
Project-URL: Issues, https://github.com/anupamshaw6471/screenshot-saver/issues
Keywords: screenshot,clipboard,snipping,tool,gui
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Graphics :: Capture :: Screen Capture
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pillow>=9.0
Requires-Dist: pynput>=1.7
Dynamic: license-file

# 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
