peter-sync

Bidirectional folder sync from the command line. Define folder pairs, save them as JSON, and keep both sides up to date.

Install

pip install peter-sync

From a local checkout:

python -m pip install -e ".[dev]"

Usage

Open the interactive menu:

peter-sync

Or use subcommands:

peter-sync add notes ~/Documents/Notes ~/Dropbox/Notes
peter-sync list
peter-sync sync notes
peter-sync sync
peter-sync remove notes

Settings are stored at ~/.peter-sync/settings.json unless you pass --settings.

Example settings file:

{
  "pairs": [
    {
      "name": "notes",
      "left": "/Users/you/Documents/Notes",
      "right": "/Users/you/Dropbox/Notes",
      "snapshot": ["todo.md"]
    }
  ]
}

How sync works

• New files are copied to the other folder.
• When both sides have the same file, the newer modification time wins.
• Identical files are left alone.
• If both files differ and have the same mtime, the pair is reported as a conflict and left unchanged.
• After the first sync, deleting a file on one side deletes it on the other. The last file list is stored in the settings JSON.

Publish to PyPI

1. Create an API token at https://pypi.org/manage/account/token/
2. Build and upload:

python -m pip install build twine
python -m build
python -m twine upload dist/*

Or publish a GitHub Release and use .github/workflows/publish.yml with trusted publishing (or a PYPI_API_TOKEN repository secret).

Develop

python -m pip install -e ".[dev]"
pytest