Skip to main content

Local file synchronization tool

Project description

Cync

A blazing-fast, I/O-efficient Python tool for local file synchronization.

Cync is a fast and efficient local file synchronization tool.
It detects and syncs changes with minimal disk I/O, making updates faster and more resource-friendly.


🚀 Features

  • Metadata-based comparison
    Compares file size and modification timestamps before falling back to byte-level comparison.

  • Reduced disk I/O
    Skips files that haven't changed to avoid unnecessary reads/writes.

  • Partial file copying
    Only modified byte ranges are transferred, not entire files.


📦 Installation

You can install Cync via PyPI using pip:

pip install cync

Alternatively, clone the repository and run it directly:

git clone https://github.com/ZacharyShonk/Cync.git
cd Cync
python3 main.py /path/to/source /path/to/destination

🛠️ Usage

python3 -m cync /path/to/source /path/to/destination

or if running from the cloned repo:

python3 main.py /path/to/source /path/to/destination
  • /path/to/source: The directory you want to sync from.
  • /path/to/destination: The target directory to sync to.

👤 Author


📊 Project Status

Python Maintenance Last Commit Issues GPLv3 License


🔮 Planned Features (In order of priority)

  • Add filters (includes/excludes)
  • Dry-run mode to preview changes
  • Progress bar with estimated time remaining
  • Multithreaded syncing

📄 License

This project is licensed under the GNU General Public License v3.0 (GPLv3).

You are free to use, modify, and distribute this software under the terms of this license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cync-1.0.0.tar.gz (16.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cync-1.0.0-py3-none-any.whl (16.6 kB view details)

Uploaded Python 3

File details

Details for the file cync-1.0.0.tar.gz.

File metadata

  • Download URL: cync-1.0.0.tar.gz
  • Upload date:
  • Size: 16.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for cync-1.0.0.tar.gz
Algorithm Hash digest
SHA256 c2ea05de89f19dd58eb86a429e8a8def53a1a5fe0ddc5ce6ccde3c1b0c60bd0c
MD5 1d7bb9ae7b59cd80faad11048cb49986
BLAKE2b-256 3de61547f7305b2dab0e47d24b94918d052d5927cbc7aad28e17310a4a1f0acb

See more details on using hashes here.

File details

Details for the file cync-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: cync-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 16.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for cync-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b9821cd4699e6a6e19481dd08e3bc500b75a916708fc751e19d3f2a8d9e57e9f
MD5 8916f98178c8f6ab04a6f5ad36b82010
BLAKE2b-256 8852b73931034646488d92fae0eda26917fdddbbbcf9f084ac057600ed122d90

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page