Repository navigation
Overview
Smart File Sync v4.2.0 delivers major architectural performance optimizations, kernel-level I/O acceleration, and critical stability fixes for large-scale enterprise synchronizations (tested up to 66,000+ files and 7.5+ GB on SSD, plus continuous multi-drive endurance up to 105,000+ files).
Throughput has increased by up to 300x, scaling from 5.0 files/second to over 1,900 files/second on modern Windows systems, while maintaining zero UI freezing and strict offline data integrity.
What's Changed
1. High-Performance Win32 Kernel Transfer Engine
- Direct DMA File Copying (
CopyFileExW): Integrated native Windows Win32 kernel API withCOPY_FILE_COPY_SYMLINKsupport, bypassing userspace buffer allocation for maximum I/O throughput. - Upfront Destination Directory Pre-Creation: Batch-created destination folders ahead of file writes, eliminating over 60,000 redundant
os.makedirsfilesystem queries. - Fast In-Memory Delta Verification: Replaced iterative MD5 block hashing with high-speed C-level byte comparisons (
src_block != dst_block) for modified files, reducing chunk comparison overhead by 70x. - Smart Delta Guard: Restricted delta calculations strictly to modified files >= 1MB to avoid computation overhead on small files (which copy instantly via kernel DMA).
2. Sliding Window ThreadPool & Hardware-Adaptive Presets
- Bounded Concurrency Window: Replaced monolithic task queuing with a bounded sliding window pool (
max_in_flight64-128). - Instant Pause & Cancellation: State transitions for Pause and Stop now execute immediately (< 10ms) without waiting for thousands of scheduled futures.
- Hardware-Adaptive Core Presets: Presets adapt dynamically to CPU topology: Eco (50% cores), Balanced (1:1 match with CPU logical cores, e.g. 8 cores = 8 threads), and Turbo Boost (200% core saturation), with manual slider support up to 32 worker threads.
- Reduced Memory Footprint: Active memory usage remains under 5 MB throughout sync execution regardless of queue size.
3. UI Virtualization, High-Contrast Typography & Zero-Lag
- Enhanced High-Contrast Typography: Upgraded UI font scaling across Folder Setup, Stat Cards, Scan Results, and Dashboard with high-contrast color coding (#38bdf8 cyan size badges, #f8fafc white counts) and 40px primary action buttons.
- O(1) Interactive Header Calculations: Replaced
ResizeToContentson high-row tables with fixed interactive proportions, eliminating Qt font layout recalculation lag that previously saturated Python's GIL. - Batched Signal Processing: Throttled GUI queue updates and progress bars to 40-80ms intervals with deduplicated row indexing and guaranteed 100% completion capture.
- Zero-Lag Search & Filtering: Implemented constant-time counting shortcuts in scan results view to prevent keystroke latency on datasets with 60k+ rows.
- Lifecycle Button State Management: Automatically resets and dims Pause and Stop button states upon job termination or error.
- Sync Queue Context Menu: Added right-click context menu options to open file in Explorer, open destination folder, and copy file paths.
4. Enterprise Filesystem & Storage Robustness
- 64-Bit Capacity Signal Handling: Upgraded all PySide6 metadata signals to native
qint64, guaranteeing seamless, overflow-free handling of multi-terabyte drives (> 4GB to 9 Exabytes). - Smart Destination Path Validation: Differentiates between disconnected physical drives and brand-new target folders, offering seamless automated directory creation on scan.
- FAT32 / exFAT 2-Second Tolerance: Added a 2.0-second timestamp buffer during directory scans to eliminate false 'Modified' alerts caused by 2-second timestamp resolution on USB drives.
- Nested Folder Loop Protection: Enforced source-destination validation preventing circular synchronization loops when a destination directory resides within the source.
- Long Enterprise UNC Paths: Full support for Windows extended paths (
\\?\UNC\...) exceeding 260 characters on network shares.
5. Automated Scheduling, CLI & Enterprise Capabilities
- Two-Way CLI Bidirectional Sync: Headless CLI now supports full bidirectional synchronization via
--mode two-way(orbidirectional) alongside standardcopyandmirrormodes with automatic timestamp-based conflict resolution and mirror orphan pruning. - Automated Periodic Scheduler: Built-in background timer executes unattended synchronizations at configurable intervals (every 5 min, 15 min, 30 min, 1 hr, or 2 hr).
- Pre & Post Sync Scripting: Hook custom batch scripts, PowerShell commands, or Python scripts to run before sync begins or after completion (e.g. database pause or auto-eject).
- Multi-Version File Archiving: Configurable safety archive preserves 1, 3, or 5 historical backup revisions in structured version archives before overwriting modified files.
- Bandwidth Rate Limiting: Adjustable transfer speed limiter (0 to 100 MB/s or unlimited) prevents background backups from saturating network or disk bandwidth.
- Persistent Scan Caching: Maintains persistent JSON filesystem index caches (
metadata_cache.json) for instant differential scans of 100,000+ files in fractions of a second.
6. Stripped Standalone Binaries (Zero Bloat)
- Bloat Removal: Removed 92 unused foreign language translation files (
.qm) and 14 unnecessary platform/image plugins (virtual keyboard, direct2d, tiff, webp decoders). - Distribution Footprint: Reduced portable distribution size by ~10 MB (from 61 MB down to 52 MB; standalone executable down to 23.6 MB).
Comparison: Smart File Sync vs Alternatives
| Feature Capability | Smart File Sync v4.2 | GoodSync (Commercial) | FreeFileSync | Robocopy (Windows) | TeraCopy Pro |
|---|---|---|---|---|---|
| Pricing & License | 100% Free & Open Source (MIT) | $29.95 / year subscription | Free (Donation for auto) | Free (Windows Built-in) | $24.95 One-Time Purchase |
| Engine Architecture | Win32 Kernel DMA FastCopy | Userspace Engine | Multi-Threaded C++ | Win32 CLI Native | Custom Buffer Engine |
| Block-Level Delta (4KB) | Included (C-Level Diff) | Included | No (Full file re-copy) | No (Full file re-copy) | No (Full file re-copy) |
| Throughput (66k files) | 1,906+ files/sec (~35s) | ~400 files/sec (~2.8 mins) | ~650 files/sec (~1.7 mins) | ~1,200 files/sec (~55s) | ~500 files/sec (~2.2 mins) |
| USB FAT32 2s Tolerance | Automatic 2.0s Buffer | Configurable | Included | Manual (/FFT flag) | Triggers Re-copies |
| USB Hardware Auto-Detect | Integrated Hardware Thread | Included | Requires RealtimeSync | None | None |
| Real-Time Watcher | Integrated Watchdog | Included | Requires RealtimeSync | Limited (/MON switch) | None |
| Automated Scheduler | Built-In (5m to 2hr intervals) | Included | Requires Task Scheduler | Requires Task Scheduler | None |
| Pre / Post Scripts | Built-In (.bat, .ps1, .py) | Included | External batch setup | None | None |
| Multi-Version Archiving | Configurable (1, 3, 5 versions) | Included | Versioning folder | None | None |
| Bandwidth Throttling | Built-In Slider (MB/s) | Included | None | /IPG inter-packet gap | None |
| Circular Loop Protection | Enforced Parent/Child Check | Basic | Basic | Prone to /XJ loops | Basic |
| Extended UNC Paths | Supported (\?\UNC...) | Supported | Supported | Supported | Supported |
| Memory Under Load | < 5 MB (Bounded Window) | 100 MB+ | 50 MB+ | Low (Console only) | 80 MB+ |
| Desktop UI Responsiveness | Silky Smooth 60 FPS (40ms batch) | Stutters on 50k+ files | Moderate redraw lag | Console Only | Standard UI |
| Standalone Portable Exe | Yes (23.6 MB Single File) | Installer Required | Portable Available | Included in Windows | Installer Required |
Automated Verification & Benchmarks
- Unit & Integration Suite: 33/33 automated tests passing (100% pass rate).
- 100 Small Files Sync: 0.051s (~1,944 files/second).
- 1,000 Files End-to-End Test: 0.435s (~2,298 files/second).
- Sliding Window 300 Files (16 Threads): 0.138s (~2,180 files/second).
- Real-World Multi-Drive Endurance: 105,661 files (16.35 GB) synchronized across 6 consecutive live multi-workload sessions with 0 errors and 100% data fidelity.
Assets Included
SmartFileSync.exe(23.6 MB) — Single-file standalone executable.SmartFileSync-Portable.zip(23.5 MB) — Portable zero-extraction directory distribution.