syncthing/syncthing-macos
Syncthing Macos
Syncthing macOS is a native application bundle that wraps the Syncthing binary to provide decentralized, peer-to-peer file synchronization on macOS. It enables bidirectional data replication across multiple devices using a block exchange protocol, allowing files and folders to stay consistent without relying on a central cloud server.
The project distinguishes itself by integrating the cross-platform synchronization engine into the macOS environment as a background service. It provides a system tray interface for quick access to the management GUI and supports automatic application startup through the system launch manager.
The software covers a broad range of synchronization and networking capabilities, including global and local device discovery, file versioning, and conflict resolution. It includes security features such as TLS peer connections, password-based folder encryption for untrusted nodes, and administrative access controls. The system also supports network optimization through relay routing, automatic port forwarding, and proxy configuration.
The application is distributed as a native macOS bundle that manages the lifecycle of the synchronization process and provides a visual interface for configuring device connections and shared folders.
Features
- Mesh File Synchronization - Provides decentralized file synchronization across a mesh network without relying on central cloud servers.
- Peer-to-Peer Data Exchange - Uses a decentralized block exchange protocol to synchronize file data and metadata between peers.
- Peer-to-Peer Networking - Establishes direct encrypted connections between devices for decentralized data exchange without a central server.
- Folder-Level Data Encryption - Encrypts entire folder structures using passwords to ensure data remains unreadable on untrusted remote nodes.
- Application Bundles - Provides a native macOS bundle that integrates the Syncthing binary with a system tray interface.
- Cross-Device File Backups - Maintains mirrored copies of files across different computers to prevent data loss and ensure consistency.
- P2P Block Exchange - Uses a standardized block exchange protocol to synchronize file data and metadata between peer nodes.
- Directional Sync Modes - Allows configuration of one-way and two-way synchronization modes to control data flow between devices.
- Peer-to-Peer File Synchronization - Replicates files and folders across multiple devices without relying on a central cloud server.
- Bidirectional File Synchronization - Implements two-way replication of files and directories across multiple devices without a central server.
- Synchronization Folder Configurations - Defines local directories for synchronization and configures scanning intervals and filesystem watchers.
- Global Discovery - Locates remote synchronization nodes over the internet using authenticated global discovery servers.
- Device Management APIs - Provides programmatic interfaces for registering remote devices and configuring their connection settings.
- Decentralized Data Replication - Provides bidirectional file synchronization using a block exchange protocol to maintain consistency across a mesh network.
- Local Peer Discovery - Identifies synchronization nodes within a local network using broadcast traffic for initial connectivity.
- Mesh Network Managers - Manages device pairing states and folder sharing requests within the peer-to-peer mesh topology.
- P2P Folder Synchronization - Implements decentralized folder synchronization, managing ownership and extended attributes across devices.
- Peer Device Discovery - Provides automated discovery of other synchronization nodes on local and global networks to establish peer connections.
- Peer Discovery - Implements mechanisms to locate remote synchronization nodes using unique IDs and listening ports.
- Application Bundling - Wraps the synchronization binary as a native macOS application bundle for background operation.
- macOS Background Services - Runs the synchronization process as a native background service that starts automatically upon user login.
- Native Application Wrappers - Integrates a cross-platform synchronization binary into a native macOS bundle with automatic startup.
- File Change Detection - Monitors files for modifications using filesystem notifications and scheduled scans to trigger synchronization.
- Untrusted Device Encryption - Hides file contents and metadata from peers using per-file keys so untrusted nodes store data blindly.
- TLS Transfer Security - Establishes secure encrypted data transfers between devices using TLS to prevent unauthorized inspection.
- Filesystem Event Triggers - Uses OS-level filesystem notifications and scheduled scans to trigger real-time synchronization events.
- System Tray Wrappers - Provides a system tray interface for quick access to the management GUI and shared folder shortcuts.
- User Session Application Launchers - Allows the synchronization process to start automatically upon user login.
- File Versioning Strategies - Compares local file states against global versions and transfers missing data blocks for consistency.
- Background Update Execution - Installs new software versions using a background update mechanism tied to remote releases.
- Synchronization Filtering - Implements mechanisms to include or exclude specific files and folders from synchronization using patterns.
- Sync Exclusions - Uses glob patterns to exclude specific files or directories from being synchronized across devices.
- REST APIs - Provides a REST API for programmatic management of system settings and synchronization status.
- File Version Retention Rules - Implements staggered retention strategies and trash cans to preserve historical versions of replaced or deleted files.
- Automated Software Updates - Automatically checks for and applies new software versions via HTTPS at startup and periodic intervals.
- Encrypted Network Relays - Establishes data connections through intermediary relay nodes for devices that cannot communicate directly.
- Automatic Port Mapping - Uses UPnP and NAT-PMP to automatically configure router port mappings for external P2P connectivity.
- Network Connectivity Configurations - Configures proxy usage, timeouts, and source addressing to ensure stable communication between nodes.
- Local Network Containment - Confines all communication to the local network by disabling global discovery, NAT traversal, and relaying.
- Remote Management Interfaces - Configures the web GUI to listen on all network interfaces for remote administration.
- Synchronization State Monitoring - Tracks real-time sync state, data volume, and errors for individual folders to ensure files are current.
- Relay-Based Routing - Bounces data through intermediate relay servers to maintain connectivity for peers behind restrictive firewalls.
- Identifier-Based Address Resolution - Retrieves current connection addresses for a specific device from a discovery server using its unique identifier.
- REST Administrative APIs - Provides a REST-based administrative interface for controlling synchronization operations and system settings.
- Automated Startup Configurations - Registers the synchronization process with the system launch manager for automatic startup upon login.
- File Encryptions and Decryptions - Extracts and decrypts files from encrypted remote devices to a local directory using a password.
- Server Identity Verification - Validates discovery server authenticity using certificate pinning and fingerprint verification to prevent spoofing.
- Interface Access Security - Protects the web management interface using passwords, TLS encryption, and authentication proxies.
- Discovery Server Registrations - Registers device connection addresses with discovery servers via authenticated requests to make nodes reachable.
- Network Access Controls - Defines specific network ranges that a device is permitted to use for establishing connections.
- Sync Conflict Resolution - Detects simultaneous modifications to the same file and preserves both versions via renaming.
- Management Interface Networking - Provides network-level configuration for the management interface, including address binding and port settings.
- Application Lifecycle Management - Manages the operational state of the synchronization process through restarts, shutdowns, and error clearing.
- Device Connectivity Tracking - Displays real-time connection status and aggregate transfer rates for all paired remote devices.
- Synchronization Status Monitoring - Provides real-time tracking of data synchronization progress and health across distributed nodes.
- Configuration GUIs - Provides a visual graphical interface for configuring device connections and shared folder settings.
