LiveSync

LiveSync is a Visual Studio Code extension that lets you instantly sync your local workspace with a remote folder over SSH/SFTP — with real-time difference tracking, customizable sync events, and an intuitive visual interface.

It’s perfect for developers working with remote servers, staging environments, Raspberry Pis, or any SSH-accessible machine.
No more manual uploads, terminal back-and-forth, or wondering if a file is out of sync.

⚡ Features at a Glance

• 🟢 Live Difference View – Visualize what’s changed between local and remote at a glance.
• 🔁 Two-Way Sync Options – Choose whether to sync on file create, save, delete, move, etc.
• ⚙️ Flexible Event Rules – Set each event to trigger check, upload, download, or do nothing.
• 📂 Folder & File Sync – Manually upload/download files or entire directories.
• 🧩 Ignore Patterns – Use glob-style rules to exclude node_modules, .git, etc.
• 🖱️ Context Menu Integration – Sync directly from the file explorer via right-click.
• 🌲 Tree/List Views – Choose how to visualize and act on changed files.
• 🎛️ Visual Configuration Panel – Set up without touching JSON files (but you still can).

🚀 Quick Start

1. Install the Extension

• Open VS Code
• Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
• Search for LiveSync
• Click Install

2. Set Up Your Connection

• Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
• Run: LiveSync: Open Configuration Panel
• Fill in your SSH/SFTP info
• Click Test Connection → then Save

📸 Example:

3. Start Syncing

• Open the LiveSync Tree View in the sidebar
• Right-click a file or folder → Upload, Download, or Show Diff
• Toggle between tree/list view, hide unchanged files, or refresh diffs

📸 Example:

⚙️ Configuration Options

Option 1: Use the Configuration Panel (Recommended)

The configuration panel is the easiest way to get started — no need to edit files manually.

How to Access It:

• Open Command Palette → LiveSync: Open Configuration Panel
• Or click the LiveSync icon in the status bar (bottom-left corner)

📸 Example:

Option 2: Manual .vscode/settings.json Setup

If you prefer to edit your workspace settings manually:

{
  "LiveSync.hostname": "your.server.com",
  "LiveSync.port": 22,
  "LiveSync.username": "your-username",
  "LiveSync.privateKeyPath": "/path/to/private/key",
  "LiveSync.remotePath": "/remote/path/to/sync",
  "LiveSync.ignoreList": [".vscode", ".git", "node_modules"],

  "LiveSync.actionOnUpload": "check&upload",
  "LiveSync.actionOnDownload": "check&download",
  "LiveSync.actionOnSave": "check&save",
  "LiveSync.actionOnDelete": "none",
  "LiveSync.actionOnMove": "check&move",
  "LiveSync.actionOnCreate": "create",
  "LiveSync.actionOnOpen": "check&download"
}

🌳 Tree View Features

LiveSync’s Tree View helps you visualize and manage file differences between local and remote folders.

Available Actions:

• 📄 View Diffs – Click a file to see the local vs. remote difference
• ⬆ Upload / ⬇ Download – Right-click files or folders to sync manually
• 🔄 Refresh Differences – Re-scan the current project to update changes
• 📁 Tree vs. List View – Choose how you browse files (hierarchical or flat)
• 👁 Hide/Show Unchanged Files – Clean up the view for faster triaging
• 📉 Collapse All – Quickly collapse the entire folder tree

💡 Tips & Troubleshooting

• Works best with stable SSH/SFTP connections (slow networks may cause delays)
• You can mix event-based and manual sync as needed
• If something isn’t syncing right, check the Output Panel for logs

📣 Contribute or Report Issues

Found a bug or have a feature idea?
Open an issue on GitHub: LiveSync Issues

📌 License

This extension is licensed under the GPT-3 License.
See LICENSE for details.