⚠️ v1.5 users: Auto-update will not work due to a signing key change. Please download v1.5.1 manually. Future updates will auto-update normally.
- Fixed Update Detection - Resolved an issue where the app incorrectly prompted for updates when already on the latest version
- Auto-Updates via Sparkle - The app can now check for and install updates automatically
- Update Button - Quick access to check for updates from the footer or Settings
- Automatic Update Checking - Configurable in Settings with toggle to enable/disable
- Settings Migration - Fixed issue where settings were lost when upgrading from v1.2 due to bundle ID change
- Fixed Dock Icon Behavior - The dock icon now correctly disappears when the main window is closed, maintaining the app's menu bar-only design when no windows are open
- Redesigned UI Layout - Ultra-compact multi-column layouts for better space utilization
- Collapsible Sections - Expandable device and folder details with disclosure groups
- Enhanced Activity Charts - Collapsible transfer speed charts with improved visualization
- Demo Mode Scenarios - Quick test scenarios including high-speed transfers
- Improved Layout Stability - Fixed header shifting issues during updates
- Better Data Alignment - Standardized spacing and alignment across all views
- Fixed layout shifting in system statistics header
- Resolved transfer speed display alignment issues
- Improved monospaced digit formatting for stable number displays
- Comprehensive code quality improvements and optimized view rendering
- Menu Bar Integration: Unobtrusive status indicator that lives in your macOS menu bar
- Real-Time Monitoring: Automatic updates every 10 seconds
- Visual Status Indicators:
Synced: When synced to at least one device
Disconnected: When Syncthing is unreachable or needs attention
- Device Monitoring: Track connection status, sync progress, and transfer rates for all remote devices
- Folder Status: View sync state, file counts, and data sizes for each shared folder
- System Information: Display device name, uptime, and version information
- System Statistics: View total folders, connected devices, data sizes, and current transfer speeds
- Sync Completion Notifications: Get macOS notifications when folders finish syncing
- Configurable Thresholds: Customize when devices are considered "synced" (percentage and remaining data)
- Automatic Configuration: Discovers API key from local Syncthing config.xml
- Manual Mode: Connect to remote Syncthing instances with custom URL and API key
- Secure Credential Storage: API keys stored in macOS Keychain
The main interface - quick access from your menu bar. The size can be adjusted via Settings in the General section using the "Popover Max Height" slider (controls how tall the popover can grow before showing scrollbars).
| Small | Medium | Large |
|---|---|---|
 |
 |
 |
Detailed overview with system statistics, expandable device and folder details.
Expandable sections showing comprehensive device and folder information.
Comprehensive configuration options for customizing the app to your needs.
General & Connection Mode - Launch at login settings, popover max height control, and connection mode:
Manual Configuration & Sync Thresholds - Manual connection settings and sync completion thresholds:
Monitoring & Notifications - Refresh interval and notification preferences:
Updates - Automatic update checking and manual update controls:
Test the app with simulated scenarios without affecting your actual Syncthing setup. Includes quick scenarios like "All Synced", "Syncing", "High-Speed Transfers", and more.
View detailed download statistics for each release:
gh api repos/Xpycode/syncthingStatus/releases --jq '.[] | {version: .tag_name, downloads: ([.assets[].download_count] | add)}'Or visit the Releases page to see download counts for each version.
- macOS 15.5 or later
- Syncthing installed and running
- Xcode 16.4+ (for building from source)
- Download the latest syncthingStatus.dmg from the Releases page
- Open the DMG file
- Drag syncthingStatus.app to your Applications folder
- Launch the app - it will appear in your menu bar
Note: The app is notarized by Apple and will run without security warnings.
-
Clone this repository:
git clone https://github.com/Xpycode/syncthingStatus.git cd syncthingStatus -
Open
syncthingStatus.xcodeprojin Xcode -
Build and run (⌘R)
- First Launch: The app will automatically try to discover your Syncthing configuration
- Menu Bar Icon: Click the icon to view current status
- Open in Window: For a more detailed view, click "Open in Window" from the popover
- Settings: Configure connection settings via the Settings button
- Web UI: Quick access to Syncthing's web interface
The app automatically reads your API key from:
~/Library/Application Support/Syncthing/config.xml(standard location)~/.config/syncthing/config.xml(alternative location)
To connect to a remote Syncthing instance:
- Open Settings
- Disable "Discover API key from Syncthing config.xml"
- Enter the Base URL (e.g.,
http://192.168.1.100:8384) - Enter the API key (found in Syncthing's web UI under Actions → Settings → API Key)
Built with:
- SwiftUI for modern, declarative UI
- Combine for reactive state management
- URLSession for async API calls
- Keychain Services for secure credential storage
- XMLParser for config file parsing
The app queries the following Syncthing REST API endpoints:
/rest/system/status- System information and uptime/rest/system/config- Device and folder configuration/rest/system/connections- Connection status for devices/rest/db/status- Per-folder synchronization status/rest/db/completion- Per-device completion percentage
- No data collection or telemetry
- All data stays local on your machine
- API keys stored securely in macOS Keychain
- Open source - audit the code yourself
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Curious about where the app could go next? Check out the evolving ideas in future-features.md and feel free to pitch in.
This project is licensed under the MIT License - see the LICENSE file for details.
- Syncthing - The amazing file synchronization tool this app monitors
- Built with Apple's native frameworks for optimal performance
If you encounter any issues or have suggestions, please open an issue on GitHub.
Made with ❤️ for the Syncthing community