WebDAVSync

Project Overview

WebDAV Sync is a Windows desktop file synchronization tool that monitors local directories and automatically uploads to WebDAV cloud storage (Jianguoyun).

Key Features

• File sync: Manual/scheduled/automatic sync with shared mtime change detection, skipping unchanged files
• Directory monitoring: Multiple directories monitored simultaneously, right-click to copy config paths
• Compressed upload: Optional zip compression before upload with segmented progress (copy → compress → upload)
• Incremental upload: Manual sync skips unchanged based on mtime snapshot; auto sync uploads only files detected by watchdog
• Sync heatmap: GitHub-style calendar heatmap showing daily sync activity
• Sync history: Complete history with time, directory, type, file count, duration
• Cloud browsing: Remote WebDAV directory browsing with download to persistent directory
• Config cloud sync: Pull on startup → manual backup → upload on exit
• Scheduled sync: Multiple configurable time points
• Security: Credentials stored only locally (config.json gitignored)

Target Audience

• Users who need automatic local-to-WebDAV sync
• Users of Jianguoyun, Nextcloud, Synology, and other WebDAV storage
• Windows users

Quick Start

1. Install dependencies: pip install pyqt6 qfluentwidgets webdav3 watchdog lxml requests python-dateutil
2. Fill in server address, username, password in the "WebDAV Settings" page (Jianguoyun requires app password)
3. Add local directories to sync in the "Monitor Directories" page
4. Choose manual, scheduled, or automatic sync to start

Core Advantages

• Incremental upload based on mtime change detection for efficient sync
• GitHub-style sync heatmap for intuitive activity display
• Supports Jianguoyun and other WebDAV cloud storage
• Credentials stored only locally for security

System Requirements

• OS: Windows
• Additional dependencies: Python 3.10+, PyQt6, qfluentwidgets, webdav3, watchdog, lxml, requests, python-dateutil