# Slides Thief agent reference

Slides Thief corrects perspective distortion in photographs of projected slides or paper documents and exports corrected images as one PDF. It is useful for conferences, classrooms, lectures, meeting rooms, trade shows, and document capture.

## Browser application

Open https://slidesthief.com/. Select JPEG, PNG, WebP, HEIC, or HEIF photos; run automatic straightening; inspect the result; drag any incorrect corner handles; generate and download the PDF. Processing and PDF generation happen locally in the browser. Source photos are not uploaded.

Usage analytics is on by default after saved preferences are checked and can be disabled in the About dialog. Google Analytics receives page views and app events with import/export counts, corner-adjustment events, and fixed error codes. App events never include filenames, file sizes, raw errors, source-image pixels, or generated PDFs. The choice is saved locally and can be changed at any time. The Google Analytics data stream must disable automatic file-download measurement to prevent its separate file_name parameter.

### Web features

<!-- BEGIN GENERATED: llms-web-en -->
- Source formats: 16:9 by default, with explicit 4:3, 16:10, A4, Letter, and custom ratios.
- PDF layouts: match the selected source format, physical A4 landscape/portrait, A3 landscape/portrait, Letter landscape/portrait paper, or custom pixel dimensions. Page margins use the selected fill color; Auto samples slide content and falls back to white.
<!-- END GENERATED: llms-web-en -->
- Settings: output width, quality, fill color, and enhancement modes (`original`, `clean`, `high-contrast`, `bw`).
- UI languages: Simplified Chinese, Traditional Chinese, English, Spanish, French, German, Japanese, Korean, and Brazilian Portuguese.
- Light and dark themes.

## Python CLI

Install the package and run:

    slides-thief INPUT_DIRECTORY --output-dir OUTPUT_DIRECTORY --source-ratio 16:9 --output-ratio match-slide --width 2400 --pdf-name flattened_slides.pdf

### CLI input formats

<!-- BEGIN GENERATED: cli-input-en -->
JPEG / JPG, PNG, TIFF, and HEIC / HEIF. WebP is web-only. HEIC / HEIF conversion uses macOS `sips`.
<!-- END GENERATED: cli-input-en -->

### CLI outputs

The requested PDF, `corrected_images/`, `detection_overlays/`, contact sheets, `manual_review.html`, `manual_review_data.json`, and `slide_lens_report.json`.

### CLI ratios

<!-- BEGIN GENERATED: cli-ratios-en -->
Presentation source ratios: 16:9 (default), 4:3, 16:10. Paper ratio presets: A4, A3, A5, Letter in landscape and portrait. Numeric custom ratios such as 1.777 work for source or output. CLI paper names set aspect ratio, not physical PDF page size; CLI paper margins are white.
<!-- END GENERATED: cli-ratios-en -->

### Common CLI options

- `--width` (default 2200), `--height`, `--jpeg-quality` (default 92)
- `--enhancement {original,clean,high-contrast,bw}`
- `--manual PATH` for a second pass with exported corner JSON
- `--work-dir`, `--clean-converted`

Run `slides-thief --help` for all options. Full contract: https://github.com/waittim/Slides-Thief/blob/main/docs/cli.md

### Manual correction

Edit corners in `manual_review.html`, export `manual_quads.json`, then run again with `--manual PATH`. Each quad is ordered top-left, top-right, bottom-right, bottom-left.

## Contracts

- https://slidesthief.com/product-metadata.json
- https://slidesthief.com/schemas/slide-lens-report.schema.json
- https://slidesthief.com/schemas/manual-quads.schema.json
- Homepage HTML discovery: `describedby` → /llms.txt, `service-doc` → /llms-full.txt, `sitemap` → /sitemap.xml

## Project and citation

Repository: https://github.com/waittim/Slides-Thief
License: MIT
Author: Zekun Wang
Citation: Wang, Z. Slides Thief: Convert photographed slides and documents into perspective-corrected PDFs. https://github.com/waittim/Slides-Thief