byteninja16/syncbridge repository overview

⁠SyncBridge

SyncBridge is a secure, high-performance file transfer tool built for local networks (LAN), fully containerized with Docker. Forget USB drives and slow cloud uploads — SyncBridge makes file sharing fast, reliable, and hassle-free.

⁠✨ Features

• ⚡ High-Speed Transfers — Multi-threaded file sending for maximum LAN throughput
• 📦 Smart Compression — Optional ZIP compression before transfer
• 🔄 Resumable Sessions — Resume interrupted transfers with session logs
• 🔐 Data Integrity — SHA-256 checksum verification
• 🐳 Dockerized — No dependencies, runs anywhere Docker does
• 🌐 Cross-Platform — Works on Windows, macOS, and Linux
• 👤 Secure by Default — Runs as non-root user, protects against path traversal

⁠🚀 Quick Start

⁠Run a SyncBridge server (receiver):

docker run -d --name syncbridge-server -p 5001:5001 \
  -v syncbridge_received:/app/received_folder \
  byteninja16/syncbridge server

⁠Send files from a client:

docker run --rm -v ./my_files:/app/files \
  byteninja16/syncbridge client \
  --paths /app/files --ip <server_ip> --port 5001

✅ Done! Files are securely transferred across your LAN.

⁠📋 Full Command Reference

SyncBridge supports a wide range of CLI arguments for performance tuning:

• Server Options: --host, --port, --dest, --buffer, --timeout
• Client Options: --paths, --ip, --threads, --retries, --resume, --zip, --zip-name

See GitHub Docs⁠ for the complete argument reference and examples.

⁠📊 Performance Tips

• Large single file (>1GB): --threads 1 --buffer 33554432
• Many small files: --threads 8 --buffer 8388608
• Unstable WiFi: --threads 2 --retries 10 --timeout 300
• Low memory devices: --buffer 1048576

⁠📄 License

Released under the Apache License 2.0. See the full license text here: LICENSE⁠.

⁠❤️ Support

• ⭐ Star the GitHub repo⁠
• 🐛 Report issues on GitHub
• 📧 Contact: [email protected]⁠

🚀 SyncBridge makes file transfers in your LAN blazingly fast, resumable, and secure — all inside a lightweight Docker container.