Local-first document detective — full-text indexing, OCR, PDF tools, duplicate detection & privacy checks in one PySide6 app.
ProFiler Suite is a local-first desktop file manager for private document collections. It combines full-text file indexing, OCR, PDF tools, duplicate detection, privacy checks, and optional ProSync integration in one Windows-oriented PySide6 app.
It is built for users who manage many local documents and want search, preview, PDF processing, and privacy workflows without uploading files to a cloud service.
- Local SQLite file index for folders, document collections, and versioned file entries
- Full-text search across PDF, DOCX, TXT, RTF, images, spreadsheets, and code files
- OCR workflow for scanned PDFs and image documents via Tesseract
- PDF utilities for encryption, decryption, page extraction, OCR, text removal, and export
- Duplicate and version handling with SHA-256 based file fingerprints
- Privacy traffic light for finding potentially sensitive files before sharing or archiving
- Cloud-placeholder awareness for OneDrive-style local file libraries
- Optional ProSync companion launcher for folder synchronization workflows
- Redacted workspace export/import for reviews, handoffs, and cross-platform smoke preparation
- Desktop GUI with dark/light theme support and system tray integration
- Included helper tools for SQLite inspection and Excel import
ProFiler is useful when you need a private document management tool for:
- searchable local archives of PDFs, Office documents, text files, and scanned paperwork
- OCR-assisted document indexing without a hosted SaaS service
- file cleanup, duplicate detection, and version review across folders
- PDF handling for small office workflows
- privacy review before forwarding, exporting, or publishing document bundles
- a companion desktop hub next to tools such as ProSync and SQLiteViewer
pip install -r requirements.txt
python Profiler_Suite_V15.pyOn Windows you can also start the app with:
START.batFor local Windows desktop use you can build a fresh launcher EXE with:
build_exe.batThe build requires a clean Git checkout, runs outside OneDrive in
C:\_Local_DEV\codex_build\profiler, uses pinned build dependencies and the
repository-local exclude scanner, and creates:
release/ProFiler-15.0.0-win64.exerelease/SHA256SUMS.txtrelease/BUILD-PROVENANCE.json
The build never copies into this checkout, OneDrive, GitHub Releases, or a
Store package. START.bat launches a local EXE only when the adjacent
ProFiler.exe.sha256 matches; otherwise a source checkout uses
Profiler_Suite_V15.py.
- Python 3.10+
- PySide6
- Tesseract OCR for OCR features
- Optional PDF/OCR libraries listed in
requirements.txt
OCR requires Tesseract and PDF-to-image conversion requires Poppler. They must currently be available on the host system; the local PyInstaller build does not bundle them. Store OCR support therefore remains blocked until package bundling and a real install smoke are verified.
On Windows, local app data and settings are stored under %LOCALAPPDATA%\ProFilerSuite. Legacy reads from ~/.profiler_suite are still accepted for existing local installs.
| File | Purpose |
|---|---|
%LOCALAPPDATA%\ProFilerSuite\profiler_config.json |
Runtime connections and index configuration |
%LOCALAPPDATA%\ProFilerSuite\profiler_settings.json |
Runtime UI settings and optional tool paths |
%LOCALAPPDATA%\ProFilerSuite\search_config.json |
Runtime search databases |
*.example.json |
Public, path-free examples; never runtime data |
PDF passwords are session-only and are deliberately removed from persisted
settings. The Excel importer is an optional administrative tool and requires
explicit --input, --database, and --output paths. Cleanup additionally
requires --cleanup --yes and a matching importer ownership marker.
python -m pip install -e ".[excel]"
python import_excel_to_profiler.py --input INPUT.xlsx --database profiler.db --output imported| Tool | Purpose |
|---|---|
Profiler_Suite_V15.py |
Main desktop application |
ProFiler_Datenschutzampel.py |
Standalone privacy traffic-light check |
SQLiteViewer.py |
SQLite database viewer for index inspection |
import_excel_to_profiler.py |
Excel import for existing file lists |
indent_gui_checker.py |
GUI indentation checker for development maintenance |
| Category | Formats |
|---|---|
| Documents | PDF, DOCX, TXT, RTF |
| Images | PNG, JPG, TIFF with OCR support |
| Spreadsheets | XLSX, XLS, CSV |
| Other files | Indexed by metadata and file category |
Looking for full-text search with BM25 ranking, LLM summarization, or a web viewer for your documents? See KnowledgeDigest, a portable knowledge database from the same author.
| ProFiler | KnowledgeDigest | |
|---|---|---|
| Focus | File management, PDF tools, OCR, privacy | Knowledge search, chunking, LLM summaries |
| Search | Multi-DB, type/size/date filters | FTS5 with BM25 ranking and snippets |
| Encrypt, decrypt, extract, redact, OCR | Read-only text extraction | |
| Privacy | Anonymization, redaction, clipboard guard | Not the focus |
| AI | Not the focus | LLM summarization and keyword extraction |
| Interfaces | Desktop GUI, system tray | Desktop GUI, web viewer, CLI, Python API |
| License | AGPL-3.0 | MIT |
ProFiler supports privacy workflows, redaction, and anonymization, but it does not guarantee complete removal of sensitive information. Always review generated files manually before sharing or publishing them.
ProFiler Suite is licensed under AGPL-3.0. See LICENSE.
This project uses PySide6 and PyMuPDF among other dependencies; see requirements.txt and THIRD_PARTY_LICENSES.txt for the full dependency list.
Windows Store preparation materials live in store_package.json, STORE_LISTING.md, PRIVACY_POLICY.md, SUPPORT.md, and WINDOWS_STORE_PREP.md.
local-first file manager, desktop document manager, private document archive, OCR desktop app, PDF OCR tool, PDF redaction, document privacy checker, PySide6 file management, SQLite document index, Windows file organizer.