# ProSync

> Last-checked: 2026-10-08 (231+ tests passing: 231+ pytest unit & contract tests + 29 node companion tests | 100% green)

Canonical repository: https://github.com/file-bricks/ProSync

Organization: file-bricks

Primary language: Python

UI stack: PySide6 desktop system-tray application

License: MIT

Attribution Notice: NOTICE

Contributing Guidelines: CONTRIBUTING.md

Security Policy: SECURITY.md (Local-First, Zero-Egress, SQLite WAL Invariants, § 521 BGB Gefälligkeitsrecht, 48h SLA)

Marketing & Governance Log: MARKETING-LOG.txt

Third-Party Licenses: THIRD_PARTY_LICENSES.md & THIRD_PARTY_LICENSES.txt (SPDX audited, Level 1 SBOM INV-LOCAL-01..INV-SLA-10, unprivileged RunAsInvoker)

ProSync is an intelligent backup synchronization tool with built-in SQLite database protection. It runs as a Windows system-tray app and supports folder sync, file sync, scheduled backups, and batch operations.

Core behavior:

- Synchronizes folders and individual files in five configurable modes: mirror, update, two_way, one_way, index_only.

- Detects and protects SQLite databases automatically (WAL checkpoint before copy, WAL file exclusion).

- Supports scheduled backups with configurable intervals, daily local execution, and a batch-sync queue for multiple connections.

- Provides a headless CLI for automation: `--list`, `--run <id|name>`, `--all`, `--config`, and `--quiet`.

- Exports redacted `prosync-profile-v1.json` for device companions and web PWA integration.

- Standardized 8-point platform smoke test suites for Linux and macOS (`tests/linux_platform_smoke.py`, `tests/macos_platform_smoke.py`).

- Windows Store staged MSIX packaging with desktop AppxManifest, full tile asset sets, and automated readiness audit (`scripts/check_store_readiness.py`).

- Optionally launches ProFiler companion for indexing and search across synchronized files.

- Multilingual localization support compliant with Policy P-006 Tier-2 (DE, EN, ES, ZH, JA, RU) with deterministic 4-tier fallback and automated translation catalog verification (`manage_translations.py --check`).

- Automated repository contract and metadata parity suite (`tests/test_metadata.py`).

- Comprehensive marketing, discovery, and governance log (`MARKETING-LOG.txt`) with competitive matrix and 10 runtime invariant pillars.

- Trilingual 18-point quick navigation parity across `README.md`, `README_de.md`, and `README.es.md` with reciprocal dual HTML anchors `sec-01`..`sec-18`.

- Standardized ASCII Four-View Architectural Topology in Section 2 across all three languages.

- Hardened CI lifecycle automation: `.github/workflows/auto-assign.yml`, `label-sync.yml`, and canonical `.github/labels.yml` with 11 standard labels.

Privacy boundary:

- ProSync does not transmit any data. All sync operations run locally (Zero-Egress).

- `ProSync_config.json` with personal source/target paths is excluded from the repository.

- The tracked `ProSync_config.example.json` contains only an empty template structure.

Local verification:

```bash

python -m pytest -ra -v # 231 Python tests (100% green)

cd web_companion && npm test # 29 Node PWA companion tests (260 total tests)

python scripts/check_store_readiness.py # Windows Store readiness auditor

python run_tests.py # 21 test suites locally

python -m compileall -q ProSyncStart_V3.1.py ProSyncReader.py prosync_utils.py

```

## Audience

- Windows users who need reliable, scheduled backup sync between local or network folders

- Developers and power users managing SQLite databases who need safe, consistent backups

- Privacy-conscious users who want a local-only sync tool with no cloud dependency

- Users of the file-bricks suite looking for ProFiler companion integration

## Search Phrases

- ProSync Windows backup synchronization PySide6

- local SQLite database backup sync tool

- Windows system tray folder sync scheduled backup

- WAL checkpoint SQLite safe copy Python

- file-bricks ProSync batch sync desktop app

- two-way folder synchronization Windows offline

- ProFiler companion file indexing sync

- local-first offline backup privacy-first

- SQLite WAL safe copy python backup

- Windows Store MSIX local backup sync utility

## Related Tools

- [llm-note](https://github.com/doc-bricks/llm-note): Local SQLite and plain-text notebook for personal or agent notes.

## Last-checked: 2026-09-28