ProFiler Suite

English | Deutsch | GitHub

Local-first document detective — full-text indexing, OCR, PDF tools, duplicate detection & privacy checks in one PySide6 app.

ProFiler Suite is a Windows-oriented PySide6 desktop app for indexing user-selected local folders, OCR, PDF workflows, SHA-256 duplicate detection, and sensitive-term review. Its indexes and application settings are stored locally; their exact locations depend on configuration and operating system. The source also contains an optional, user-invoked GitHub module installer. The reviewed first-party paths showed no automatic upload of document contents or telemetry; the application does not block network traffic or control the operating system and external libraries.

ProFiler can help users work with local or user-selected files. Review results and redactions before sharing. The module installer can contact GitHub when explicitly invoked; ProFiler is not an egress filter or a compliance/privacy certification.

1. Architecture
2. Workflow Lifecycle
3. Core Capabilities & Security Invariants
4. Target Personas & Use Cases
5. Comparative Matrix & Alternatives
6. Feature Highlights
7. Visual Interface & Screenshot
8. When To Use ProFiler
9. Quick Start & Setup
10. Windows Launcher & Build Flow
11. Configuration & Local Storage
12. Included Tools & Utilities
13. Supported File Formats & OCR
14. Sibling Ecosystem & Integrations
15. Third-Party Licenses
16. Security Policy
17. Target Personas & High-Intent SEO
18. Verification & Test Suite

graph TD
    subgraph Sources["1. Document & File Sources"]
        A1["Local Directory Tree"]
        A2["Document Folders (PDF, DOCX, TXT, RTF)"]
        A3["Scanned Paperwork & Images"]
        A4["OneDrive Mounts (Cloud-Placeholder Aware)"]
    end

    subgraph CoreEngine["2. Core Ingestion & Indexing"]
        B1["Crawler & File Watchdog"]
        B2["SHA-256 Fingerprinting"]
        B3["SQLite Local Index (Versions, Metadata)"]
    end

    subgraph Processing["3. Document & PDF Processing Layer"]
        C1["Tesseract OCR Engine"]
        C2["PDF Utilities (Encrypt, Decrypt, Extract, Redact)"]
        C3["Deduplication & Version Tracker"]
    end

    subgraph PrivacyGate["4. Review & Workspace Exchange"]
        D1["Sensitive-term pattern review"]
        D2["Redacted Workspace Exchange (JSON Schema v1)"]
    end

    subgraph UI["5. Presentation & Companion Integration"]
        E1["PySide6 UnifiedMainWindow (Dark/Light Themes)"]
        E2["SQLiteViewer (Index Inspector)"]
        E3["ProSync Sibling Launcher"]
    end

    Sources --> CoreEngine
    CoreEngine --> Processing
    Processing --> PrivacyGate
    PrivacyGate --> UI

sequenceDiagram
    autonumber
    actor User as Desktop User
    participant UI as PySide6 GUI (UnifiedMainWindow)
    participant Crawler as File Watchdog & Crawler
    participant Index as SQLite Local Index
    participant OCR as Tesseract OCR / PDF Engine
    participant Gate as Datenschutzampel (Rule-Based Pattern Check)
    participant Exchange as Redacted Workspace Exchange

    User->>UI: Select document folder or file
    UI->>Crawler: Scan path & calculate SHA-256 fingerprint
    Crawler->>Index: Store file metadata & version state
    opt Scanned Document / Image PDF
        UI->>OCR: Trigger Tesseract OCR / text extraction
        OCR->>Index: Update full-text search index (FTS)
    end
    User->>UI: Request document export / sharing
    UI->>Gate: Run heuristic sensitive-term check
    alt Sensitive Data Detected
        Gate-->>UI: Warning / Redaction prompt (Datenschutzampel RED/YELLOW)
        User->>UI: Apply PDF redaction / anonymize workspace
    else Safe Document
        Gate-->>UI: No configured pattern matched
    end
    UI->>Exchange: Export redacted workspace JSON (Schema v1)
    Exchange-->>User: Schema-validated workspace export

ProFiler focuses on local file management, search indexes, and selected OCR/PDF workflows. The projects below serve different workflows; this table does not claim a feature or security assessment of them.

• Local SQLite File Index: Rapid indexing for folders, document collections, and versioned file entries.
• Full-Text Search Engine: Search across PDF, DOCX, TXT, RTF, images, spreadsheets, and source code.
• Tesseract OCR Integration: Automatic OCR workflow for scanned PDFs and image documents.
• Comprehensive PDF Workshop: Encrypt, decrypt, extract pages, redact text, and export sanitized documents.
• Cryptographic Deduplication: Fast SHA-256 fingerprinting to identify redundant duplicate files.
• Privacy review: Rule-based warnings for possible sensitive terms before sharing; inspect results manually.
• Cloud-placeholder handling: The crawler recognizes supported placeholder states; behavior depends on platform and file system.
• ProSync Companion Integration: Direct launcher bridge for synchronizing managed folder pairs.
• Redacted Workspace Exchange: Export and import portable workspaces via JSON Schema v1.
• Ergonomic Desktop UI: Native PySide6 interface with dark/light theme switching and system tray integration.
• Companion Utilities: Bundled SQLite database inspector (SQLiteViewer.py) and Excel file importer.

ProFiler is the optimal solution when you require a private document management tool for:

• Maintaining searchable local archives of PDFs, Office documents, text files, and scanned receipts.
• Running OCR-assisted indexing on scans when required local tools are available.
• Detecting duplicate files and auditing version drift across deep directory structures.
• Handling PDF security operations (passwords, page extractions, redactions) in a single desktop app.
• Reviewing possible sensitive terms before sharing; this is not a legal or compliance assessment.
• Optionally launching the separate ProSync tool from the menu; SQLiteViewer is a separate script in this repository.

• Python 3.10+ (tested on Python 3.10, 3.11, 3.12, 3.13)
• PySide6
• Tesseract OCR (optional, required for image and scanned PDF OCR)
• Poppler utilities (optional, required for PDF rendering and page conversion)

Install runtime dependencies from PyPI:

pip install -r requirements.txt
python Profiler_Suite_V15.py

On Windows, you can start the application directly via the bundled starter script:

START.bat

To attempt a local Windows executable build, run:

build_exe.bat

The script stops before PyInstaller unless the required files exist under runtime/tesseract/ and runtime/poppler/. It requires a clean Git checkout and uses BUILD_ROOT as a configurable local output directory.

When prerequisites are present, outputs include:

• <BUILD_ROOT>/dist/ProFiler.exe
• <BUILD_ROOT>/release/SHA256SUMS.txt
• <BUILD_ROOT>/release/BUILD-PROVENANCE.json

This is a local build flow. The script does not publish to GitHub Releases, OneDrive, or the Microsoft Store.

PDF passwords are session-only and are deliberately excluded from persisted settings. The Excel importer is an optional administrative utility:

python -m pip install -e ".[excel]"
python import_excel_to_profiler.py --input INPUT.xlsx --database profiler.db --output imported

ProFiler is part of the file-bricks tool family under the open-bricks umbrella. A link does not imply a technical integration.

Find other organization projects at file-bricks.

ProFiler itself is licensed under AGPL-3.0-only; see LICENSE.

THIRD_PARTY_LICENSES.md and THIRD_PARTY_LICENSES.txt list declared direct runtime and optional dependencies plus selected development/build tools, with links to upstream license sources. This is not a complete inventory of transitive packages or bundled binaries and is not a license-compatibility or legal review.

Before distributing a binary or Store package, review the actual artifacts, bundled components, license texts, and bundling terms separately. Existing Store files are preparation material and do not establish publication or certification.

ProFiler accepts private reports about security issues. When available, use GitHub Security Advisories. If that route is unavailable, use the alternative contact and process in SECURITY.md.

No fixed response, triage, or remediation timelines are promised. Investigation and fixes depend on reproducibility, severity, and maintainer availability.

ProFiler is for people who organize local documents and want to review possible sensitive terms before sharing. Its pattern checks do not assess legal requirements or establish GDPR compliance.

These terms describe workflows, not privacy, legal, or security certification.

Run local development checks with:

python -m pytest -ra -v
ruff check .
python -m compileall -q .
git diff --check
python source_platform_smoke.py

The source-platform-smoke.yml workflow runs compilation, the basis smoke, Linux/macOS smokes, and pytest on Ubuntu and macOS with Python 3.11. This does not establish Windows CI, the presence of OCR/Poppler binaries, native packaging, tray behavior, or Microsoft Store/WACK approval. Check current results in the Actions tab for the exact commit.

The privacy checker is a rule-based aid; review matches and any PDF redactions before sharing. ProFiler does not provide legal advice.