{"id":39855373,"url":"https://github.com/bradley101/syncmux","last_synced_at":"2026-01-20T17:28:39.972Z","repository":{"id":331652963,"uuid":"1117978335","full_name":"bradley101/syncmux","owner":"bradley101","description":"Fast file synchronization for remote development over SSH with persistent connections and robust logging.","archived":false,"fork":false,"pushed_at":"2026-01-10T16:57:47.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-11T04:42:45.046Z","etag":null,"topics":["cli","code-synchronization","developer-tools","file-synchronization","python","remote-development","rsync","ssh"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bradley101.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-17T04:58:23.000Z","updated_at":"2026-01-10T16:53:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bradley101/syncmux","commit_stats":null,"previous_names":["bradley101/syncmux"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/bradley101/syncmux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bradley101%2Fsyncmux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bradley101%2Fsyncmux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bradley101%2Fsyncmux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bradley101%2Fsyncmux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bradley101","download_url":"https://codeload.github.com/bradley101/syncmux/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bradley101%2Fsyncmux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28537019,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T13:04:05.990Z","status":"ssl_error","status_checked_at":"2026-01-18T13:01:44.092Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","code-synchronization","developer-tools","file-synchronization","python","remote-development","rsync","ssh"],"created_at":"2026-01-18T13:50:04.660Z","updated_at":"2026-01-18T13:50:05.339Z","avatar_url":"https://github.com/bradley101.png","language":"Python","readme":"# syncmux\n\nFast file synchronization for remote development over SSH. syncmux is designed for developers working on remote servers who need low-latency file syncing with persistent connections and robust logging.\n\n## Features\n\n- **🚀 Lightning Fast**: Uses SSH ControlMaster to maintain persistent connections, eliminating handshake overhead for every file.\n- **📦 Smart Batching**: Automatically switches to batch mode when multiple files change at once (e.g., switching git branches).\n- **🔄 Auto-Reconnect**: Automatically attempts to reconnect if the network drops or the SSH connection is severed.\n- **🎯 Git-Aware**: Respects `.gitignore` and logs git diffs for changes.\n- **📝 Comprehensive Logging**: Keeps detailed logs of what changed on both the local machine and the remote server.\n\n## Prerequisites\n\n- **Passwordless SSH**: You must have SSH key-based authentication set up for the remote host (e.g., via `ssh-copy-id`), allowing usage without entering a password.\n- **rsync**: Must be installed on both the local machine and the remote server.\n\n## Installation\n\n```bash\npip install syncmux\n```\n\n## Usage\n\n### Quick Start\n\nStart watching a directory and syncing to a remote server:\n\n```bash\nsyncmux --local-dir ~/myproject --remote-host dev-server --remote-dir /home/user/myproject\n```\n\n### Initial Sync\n\nIf you want to ensure the remote directory is an exact mirror of your local directory before starting the watcher (useful for fresh starts), use the `--initial-sync` flag. \n\n**⚠️ WARNING**: This will delete files on the remote directory that are not present locally.\n\n```bash\nsyncmux --local-dir ~/myproject --remote-host dev-server --remote-dir /home/user/myproject --initial-sync\n```\n\n### Command Line Reference\n\n```text\nusage: syncmux [-h] [--version] --local-dir LOCAL_DIR --remote-host REMOTE_HOST\n               --remote-dir REMOTE_DIR [--debounce DEBOUNCE]\n               [--batch-threshold BATCH_THRESHOLD]\n               [--keepalive-interval KEEPALIVE_INTERVAL]\n               [--keepalive-count KEEPALIVE_COUNT]\n               [--connection-check-interval CONNECTION_CHECK_INTERVAL]\n               [--reconnect-attempts RECONNECT_ATTEMPTS]\n               [--reconnect-delay RECONNECT_DELAY] [--initial-sync]\n\nRequired arguments:\n  --local-dir DIR       Local directory to watch\n  --remote-host HOST    Remote SSH host (as defined in ~/.ssh/config or user@host)\n  --remote-dir DIR      Remote directory path\n\nSync behavior:\n  --debounce SEC        Seconds to wait after last change before syncing (default: 2.0)\n  --batch-threshold N   Number of files to trigger batch sync mode (default: 5)\n\nConnection tuning:\n  --keepalive-interval N  SSH keepalive interval in seconds (default: 15)\n  --reconnect-attempts N  Number of reconnection attempts (default: 5)\n```\n\n## How It Works\n\n### Persistent Connection\nsyncmux sets up a master SSH connection (`ssh -M`) with `ControlPersist`. All subsequent sync operations (`rsync`) reuse this socket. This drastically reduces latency, especially on high-latency networks (like VPNs), as it avoids the SSH handshake overhead for transfer.\n\n### Logging and Diffs\nsyncmux maintains logs on both ends so you always know what happened.\n\n**Local Log** (`.syncmux-log` in your local dir):\nRecords every file synced along with the **local git diff** at the time of sync. This allows you to audit exactly what code changes were pushed.\n\n```text\n============================================================\nTimestamp: 2024-03-20 10:30:01\nSynced: src/main.py\nRemote: dev-server:/app/src/main.py\n----------------------------------------\nDiff:\ndiff --git a/src/main.py b/src/main.py\nindex ...\n...\n```\n\n**Remote Log** (`.sync-log` in your remote dir):\nRecords incoming syncs. If the remote directory is a git repo, it also attempts to capture the diff of the applied changes relative to the remote `HEAD`.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to syncmux.\n\n## License\n\nMIT License - see LICENSE file\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbradley101%2Fsyncmux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbradley101%2Fsyncmux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbradley101%2Fsyncmux/lists"}