Skip to content

pCloudSync-deconflict v1.0.0

Choose a tag to compare

View all tags
@rcfa rcfa released this 24 Jul 19:32
v1.0.0
ef20527

pCloudSync-deconflict v1.0.0

🎉 First stable release! pCloudSync-deconflict is a Python tool that finds and manages duplicate files created by pCloud sync conflicts.

✨ Key Features

  • 🔍 Smart Conflict Detection: Automatically finds files with " [conflicted]" in their names
  • ⚡ Fast File Comparison: Uses SHA256 hash comparison with size optimization
  • 📊 Real-time Progress: Live progress indicator for large directory scans
  • 🔄 Persistent Tracking: JSON-based conflict tracking across multiple runs
  • 🌐 Unicode Support: Handles all international characters in filenames
  • ☁️ Cloud Storage Aware: Intelligently excludes cloud storage directories
  • 🖥️ Multiple Modes: Interactive, auto-delete, and dry-run options

🚀 Installation

Option 1: Download and Run

# Download the universal binary
curl -L -o pCloudSync-deconflict https://github.com/rcfa/pCloudSync-deconflict/releases/download/v1.0.0/pCloudSync-deconflict
chmod +x pCloudSync-deconflict
./pCloudSync-deconflict --help

Option 2: System Installation

# Download, build from source, and install system-wide
git clone https://github.com/rcfa/pCloudSync-deconflict.git
cd pCloudSync-deconflict
make install

📖 Usage Examples

# Basic scan with confirmations
./pCloudSync-deconflict -r /path/to/folder

# Auto-delete identical conflicted files
./pCloudSync-deconflict -r --auto-delete /path/to/folder  

# Preview what would be deleted (dry run)
./pCloudSync-deconflict -r --dry-run /path/to/folder

# Scan external drives while excluding cloud storage
./pCloudSync-deconflict -r --include-local-mounts ~/

🔧 What's New in v1.0.0

This release represents months of development and testing, making the tool production-ready:

  • ✅ Feature Complete: All core functionality implemented and tested
  • ✅ Production Ready: Handles edge cases, errors, and large datasets
  • ✅ Universal Binary: Single executable works on all macOS systems
  • ✅ Smart Installation: Easy system-wide installation with make install
  • ✅ GitHub Actions: Automated code review and testing workflows
  • ✅ Comprehensive Documentation: Detailed usage examples and technical notes

🛠️ Technical Highlights

  • Efficient directory traversal using os.walk()
  • Dynamic terminal width detection for progress display
  • Graceful handling of permission errors and protected directories
  • Optimized file comparison (skips hash if sizes differ)
  • Robust Unicode support for international filenames
  • Smart cloud storage detection (FUSE, Dropbox, iCloud, etc.)

📊 Tested On

  • ✅ Large directories (millions of files)
  • ✅ Unicode filenames (Chinese, Japanese, emoji, etc.)
  • ✅ Various macOS versions (Intel and Apple Silicon)
  • ✅ Different filesystem types (APFS, HFS+, ExFAT)
  • ✅ Cloud storage integrations (pCloud, Dropbox, iCloud)

Full Changelog: https://github.com/rcfa/pCloudSync-deconflict/commits/v1.0.0

Assets 3
Loading