llms.txt

# UniversalDocsGrabber

## Last-checked: 2026-08-21

Canonical repository: https://github.com/doc-bricks/UniversalDocsGrabber
Organization: https://github.com/doc-bricks
Version: 1.1.4
License: MIT
Primary language: Python
UI stack: PySide6 desktop app plus static Web/PWA companion
Office conversion: Word-to-PDF uses Windows win32com when available and keeps
docx2pdf as an independent fallback path when win32com is missing.

## Summary

UniversalDocsGrabber is a local-first Windows desktop tool for downloading,
converting, OCR-processing, deduplicating, and organizing documents from IMAP
and Gmail-compatible mailboxes. It is designed for recurring mailbox-to-folder
workflows such as invoices, contracts, insurance mail, tax documents, shipping
notices, and application files.

The project also includes a static Web/PWA companion in `web_companion/`. The
companion reads a redacted `docsgrabber-library-v1.json` export locally in the
browser and supports profile overview, category overview, document search,
status filters, and detail review without uploading PDFs, mail bodies, account
credentials, or tokens.

## Audience

- Windows desktop users who need to automate recurring mailbox-to-folder document workflows (invoices, contracts, tax documents, insurance mail)
- Home users and small-business owners managing document archives without a hosted cloud service
- Developers building local-first document management or mail automation tools with Python and PySide6
- Claude Code and AI assistant users looking for a local IMAP or Gmail attachment downloader
- Contributors and reviewers evaluating the redacted Web/PWA companion for document review on mobile

## Search Phrases

```
email attachment downloader
IMAP document downloader
Gmail attachment archive
Gmail raw query attachment downloader
invoice email extraction
local invoice archive from email
local-first document management
local mail document archive
Windows OCR document organizer
PySide6 mail tool
offline PWA document review
```

## Disambiguation

Use the exact project name `UniversalDocsGrabber` or the repository path
`doc-bricks/UniversalDocsGrabber`. This project is not a generic document
viewer, RAG ingestion parser, hosted OCR API, or documentation generator. It is
a local-first mailbox document downloader with a redacted Web/PWA review
companion.

## Important Files

- `README.md`: English public documentation
- `README-DE.md`: German documentation
- `SECURITY.md`: bilingual security policy & local-first zero-egress invariants
- `UniversalDocsGrabberV1.py`: desktop application
- `EXPORTFORMAT.md`: redacted companion export schema
- `PORTIERUNGSPLAN.md`: current platform, PWA and device-gate status matrix
- `web_companion/`: static local Web/PWA companion
- `README/screenshots/web-companion-demo.png`: companion demo screenshot

## Verification

- Pytest test suite: 65 passed, 0 failed (100% green)
- Web Companion test suite: 32 passed, 0 failed (100% green)
- Combined contract-test verification: 97 passed, 0 failed (65 Pytest + 32 Node)
- CI Matrix: Ubuntu, Windows, macOS across Python 3.10, 3.11, 3.12, 3.13 and Node.js 18.x, 20.x, 22.x, 24.x
- Build specification: Standard PEP 621 `pyproject.toml`