Explicit direction
One-way synchronization avoids ambiguous conflict resolution and makes user intent inspectable.
Python · Tkinter · Current v0.10.0 release
TraceSync
A Windows utility that turns a risky file operation into a reviewable workflow: compare, understand, select, preview, confirm, synchronize, and audit.
- Ownership
- Product, architecture, UX, testing, and release
- Stack
- Python, Tkinter, unittest, PyInstaller
- Release
- v0.10.0 · Folder Pair Workflow
- Quality
- Full automated suite and UI coverage
The problem
File synchronization should not require blind trust
In shared-file environments, a copy can replace newer work or move files in the wrong direction. TraceSync compares first, shows differences, requires a direction, previews exact changes, and asks for confirmation.
CompareClassify differences
ReviewFilter and inspect
PreviewSee exact changes
SynchronizeConfirm and monitor
Engineering decisions
Safety controls built into the workflow
Immutable preview contract
Only reviewed, eligible files enter a job; per-file selection preserves operator control.
Pre-copy revalidation
Source and destination metadata are checked again immediately before each copy.
Accurate failure records
Execution results remain truthful even when final history persistence fails.
v0.10.0 interface
Compare, review, confirm, then copy
These captures come from the tagged v0.10.0 release and use representative office documents.
v0.10.0 scope: manual one-way synchronization only. Automatic runs, active cloud providers, bidirectional conflict resolution, backup, and rollback are not included.
Verified Windows builds
Compare the current and previous release
Both downloads are unsigned, portable Windows x64 executables built from their tagged source. v0.10.0 keeps the v0.9.1 synchronization safeguards and adds Saved Folder Pairs for recurring Local ↔ Server workflows.
Current tagged release
TraceSync v0.10.0
Folder Pair Workflow release, built from tag v0.10.0 and verified against 94 automated tests.
- Includes Saved Folder Pairs and active-pair persistence
- Retains preview, revalidation, history, and cancellation controls
- Best choice for evaluating the current released workflow
- Size
- 11.2 MB
- SHA-256
ED3504D2E0B3DDEB20A6A21AB9778297CDAC590198E2B9553762B53F5E956FB6
Previous tagged release
TraceSync v0.9.1
The roadmap-complete synchronization baseline before Folder Pairs were introduced.
- Includes selective preview and metadata revalidation
- Includes durable run history and CSV export
- Useful for comparing the v0.10.0 workflow change
- Size
- 11.2 MB
- SHA-256
02059A758A7436ECAFF5D1EEBF8AC905059EB330E502B79EB619AF8E614370B1
These portfolio builds are not code-signed, so Windows may display a SmartScreen warning. Verify the listed checksum before running either file.
Architecture
UI and filesystem behavior remain separated
MainWindow
│
SyncService
├── StorageScanner ──► StorageProvider
├── comparer ────────► ComparisonResult
└── SyncPreview ─────► SyncJobRunner ──► SyncJob
Verification
Tests and failure handling
Regression suite
Coverage spans comparison confidence, Folder Pairs, preview selection, copy safety, settings, UI behavior, persistence, export, and history recovery.
Structured run records
Versioned JSON records use validated identities, interrupted-run recovery, and bounded retention.
CSV export safety
Export protects spreadsheet users against formula injection and includes only the selected run.
Single active job
A per-user operating-system lock prevents overlapping synchronization jobs without claiming distributed locking.
Public GitHub API
Repository activity
Loading public GitHub activity…
Repository
- Loading…
Recent commits
- Loading…
Pull requests
- Loading…