RsyncUI version release notes and changelogs.
This is the multi-page printable view of this section. Click here to print.
Release Notes
- Version 3.5.0 — Scheduling and Simplified Chinese
- Version 3.1.0
- Version 3.0.5
- Version 3.0.3
- Version 3.0.2
- Version 3.0.0
- Version 2.9.8
- Version 2.9.3
Version 3.5.0 — Scheduling and Simplified Chinese
RsyncUI 3.5.0
RsyncUI 3.5.0 has been downloaded about 100 times (Nov 15) , with no issues reported. The current build will become the next release before the end of November 2026 without a rebuild. The universal macOS build is already available.
It removes built-in scheduling from RsyncUI and includes the Simplified Chinese translation introduced in the 3.2.0 translation test release.
ScheduleRsync, a separate application, manages when profiles run. RsyncUI continues to estimate and synchronize their tasks. You can also trigger RsyncUI from another scheduling tool, including Apple Shortcuts on macOS Tahoe 26 or later.
Simplified Chinese translation
The application interface now includes a Simplified Chinese translation. Many thanks to @markawonge for contributing it.
Native Chinese speakers: please help review the translation. Check whether the wording is accurate, natural, and clear. Please open an issue in the RsyncUI repository to confirm that the translation is suitable or to report incorrect wording, unclear terminology, missing translations, or layout problems. For corrections, include the current text, your suggested wording, and a screenshot where helpful.
The translation may be revised in later updates based on feedback. It was first available for review in RsyncUI 3.2.0, build 211.
Scheduling changes
Built-in scheduling is removed in version 3.5.0. Choose a scheduling tool to start your profiles:
- ScheduleRsync: a dedicated application with a calendar, repeat schedules, spacing between starts, and quiet hours. See Scheduling in ScheduleRsync.
- Apple Shortcuts: an option for simple time-based schedules on macOS Tahoe 26 or later. See Schedule with Apple Shortcuts.
- Other scheduling tools: any tool that can open a macOS URL can trigger RsyncUI, as described below.
Versions 3.1.0 and 3.2.0 support external URL commands but require a manual restart of RsyncUI before another command can run. Version 3.5.0 automatically quits after each external URL command completes, allowing the next scheduled command to launch it again.
Trigger RsyncUI with a URL
You can use any scheduling tool to schedule backups with RsyncUI, provided it can open a URL through macOS. For example, run this command in Terminal:
open "rsyncuiapp://loadprofileandestimate?profile=Default"
This opens RsyncUI, loads the selected profile, estimates its tasks, and automatically starts synchronization. Replace Default with your profile name, URL-encoding it when necessary. RsyncUI must be installed, and the Mac must be awake when the scheduling tool runs the command. ScheduleRsync provides a dedicated interface for managing these schedules, but you can choose another tool that supports running this command.
In a macOS Swift application, use AppKit to open the same URL:
import AppKit
@MainActor
func triggerRsyncUI(profile: String = "Default") {
var components = URLComponents()
components.scheme = "rsyncuiapp"
components.host = "loadprofileandestimate"
components.queryItems = [URLQueryItem(name: "profile", value: profile)]
guard let url = components.url else { return }
if !NSWorkspace.shared.open(url) {
print("Unable to open RsyncUI.")
}
}
URLComponents encodes the profile name for the URL. Call triggerRsyncUI(profile: "Default") on the main actor when the schedule is due. Opening the URL hands the command to RsyncUI; it does not confirm that synchronization has completed.
Schedule with Apple Shortcuts
Apple Shortcuts is a straightforward alternative to ScheduleRsync for simple daily or weekly schedules. It is included with macOS. Time-based automations require macOS Tahoe 26 or later; older macOS versions can run shortcuts manually but do not offer this built-in time trigger.
Create the shortcut
Open Shortcuts on your Mac and create a new shortcut, for example RsyncUI — Default.
Add the URL action and enter:
rsyncuiapp://loadprofileandestimate?profile=DefaultAdd Open URLs after the URL action, using the URL from the previous action as its input.
Replace
Defaultwith the required RsyncUI profile name. URL-encode special characters in the profile name, for exampleMy%20BackupforMy Backup.Run the shortcut manually once to check that RsyncUI opens with the correct profile, and approve any macOS permission prompt. This test can start synchronization, so use a profile that is ready to run.
Schedule the shortcut
- In Shortcuts, open Automation and add a new automation.
- Select Time of Day, choose the start time, and select the required daily, weekly, or monthly recurrence.
- Choose the shortcut you created. Select Run Immediately so it runs without waiting for confirmation; wording and placement can vary with the macOS version.
- Create additional shortcuts or time automations for other profiles and start times as needed.
RsyncUI must be installed and registered for the rsyncuiapp URL scheme. Keep the Mac awake and the user logged in for the scheduled run; this setup does not configure the Mac to wake. Shortcuts sends the same URL command as ScheduleRsync, so RsyncUI remains responsible for estimation and synchronization.
This alternative does not read ScheduleRsync’s schedule file or automatically apply its quiet hours, global minimum gap, adjusted/skipped-run planning, or wake catch-up rules. Choose times outside your quiet hours and leave enough time between profiles for synchronization to finish. Disable equivalent schedules in other tools to avoid duplicate starts.
For background and setup information, see Apple’s Shortcuts User Guide for Mac and macOS Tahoe feature overview.
Scheduling in ScheduleRsync
In ScheduleRsync, select an RsyncUI profile, choose its first run date and time, and create a schedule:
- Once: run at the selected date and time.
- Daily: repeat each day.
- Weekly: repeat each week.
- Repeat: run at a fixed interval in whole minutes, with a minimum of 30 minutes.
ScheduleRsync shows upcoming runs in a calendar and schedule list. You can inspect the profiles and times for a day, or delete a schedule series to remove its future runs.

Spacing and quiet hours
A global Minimum between tasks setting spaces scheduled starts across all profiles. The default is 15 minutes. This is a gap between start times; ScheduleRsync does not receive a completion notification from RsyncUI.
An optional Quiet period, enabled by default from 23:00 to 07:00 local time, moves starts out of those hours. Conflicting starts are delayed while keeping the original recurrence. If a delayed run would reach the next occurrence in its series, or fall outside the planning horizon, it is skipped. Adjusted runs are shown in yellow and skipped runs in red.
Keep ScheduleRsync running
ScheduleRsync must remain running with its main window open. Closing that window quits the app and stops scheduling. It does not install a background service or wake the Mac, so keep the Mac awake for runs to start on time.
After the Mac wakes, ScheduleRsync catches up on overdue runs. Multiple missed repeats are combined into one catch-up run per schedule, subject to spacing and quiet hours. Runs missed while ScheduleRsync was closed are skipped when it next opens.
Existing schedules
ScheduleRsync uses the existing RsyncUI schedule file, ~/.rsyncosx/<Mac serial>/schedule.json, and reads profiles from the same configuration directory. Existing once, daily, and weekly schedules remain readable without copying or migrating the file. Avoid running the scheduler in an older RsyncUI version alongside ScheduleRsync, as both applications could trigger the same schedules.
How ScheduleRsync triggers RsyncUI
When a schedule becomes due, ScheduleRsync opens RsyncUI using its external URL command. For the Default profile, the command is:
rsyncuiapp://loadprofileandestimate?profile=Default
ScheduleRsync substitutes the selected profile name and URL-encodes it. macOS delivers the URL to RsyncUI, launching the application if needed. RsyncUI loads that profile, estimates its tasks, and automatically starts synchronization. RsyncUI must be installed and registered to handle the rsyncuiapp URL scheme. See URL commands for more details.
ScheduleRsync manages the timing; RsyncUI performs the actual synchronization. RsyncUI may reject an incoming command if another operation is already in progress, so allow enough time between scheduled starts for your profiles to finish.
Version 3.1.0
RsyncUI 3.1.0 — Changelog
Version 3.1.0 improves the Synchronize view and task creation, fixes profile sorting, and includes the rsync error-reporting fixes introduced in the 3.0.6 release candidate.
If no issues are discovered in the release candidate, it will be published as the stable 3.1.0 release using the same builds; no new builds will be produced.
Changes since v3.0.5 through commit 9d3903a4 (October 21, 2026).
🎨 Synchronize view improvements
- Added a heading showing the current profile, task count, and selection count.
- Added a details panel for a single selected task, showing its source and destination hosts and full, selectable folder paths. The panel adapts to the available width.
- Corrected source and destination display for remote-pull tasks, including halted tasks that retain their remote-pull mode.
- Simplified the task table with clearer Task and Last run headings, destination host and folder details, and tooltips for truncated paths.
- Added clearer Halted and Never run indicators and adjusted status colors.
- Added selection guidance explaining when actions apply to all enabled tasks and when to estimate selected tasks.
- Kept Estimate & Sync visible but disabled when all tasks are halted.
➕ Task creation improvements
- Replaced red field borders with Required markers and contextual guidance for missing folders, remote users, and remote servers.
- Clarified source and destination labels for remote-pull tasks.
- Disabled Add until required fields are complete and added a matching check before attempting to create a task.
- Added guidance for completing remote connection fields or clearing them for a local task.
🐛 Error reporting and profile fixes
- Fixed rsync output error checking so it follows the user’s configured preference instead of always being enabled.
- Improved failure alerts to include the rsync exit code and a concise summary of standard error output.
- Limited the output shown in failure alerts to ten lines, preserving the most recent line containing “error” when it would otherwise fall outside the displayed summary.
- Fixed profile-name sorting on APFS filesystems using localized natural ordering. Newly created profiles are also inserted in sorted order.
🧪 Regression coverage
- Added tests for large multiline error output, error messages across multiple output chunks, and short or empty output.
- Added tests for failure-alert presentation and for enabling or disabling rsync output error checking.
🙏 Thanks
- Thanks to @daLuiz for reporting the rsync error-reporting issue.
- Thanks to @jigawho-ship-it for reporting the profile-name sorting issue on APFS filesystems.
📦 Version information
- Updated the application and widget version to
3.1.0. - Updated the application and widget build number from
208to210.
Version 3.0.5
RsyncUI 3.0.5 — Changelog
This build is the latest release; it addresses a crash occurring during compilation and execution of RsyncUI on macOS 27 beta releases. The issue manifested when selecting Tasks from the sidebar menu. The latest build also includes restore, snapshot deletion, synchronization, logging, and shared widget storage fixes completed after the first 3.0.5 tag.
Build by Xcode 27 RC1 on macOS 27 RC (macOS Golden Gate).
Changes since v3.0.3 through commit b3e9343 (September 10, 2026).
A general issue with delete arose from a missing focus state tied to a Swift update, which was resolved in the August 13 build. Additional fixes through September 7 stabilize restore workflows, process completion handling, snapshot deletion, and shared JSON storage used by the widget.
🐛 Fxes
- Fixed the recurring AppKit
Update Constraints in Windowcrash during startup. - Replaced the problematic root
NavigationSplitViewimplementation. - Stabilized task-menu identities and selection handling.
- Removed an invisible task editor that caused unnecessary Inspector layout updates.
- Moved Add Task presentation into a dedicated sheet.
- Added stable Inspector presentation state and column sizing.
- Fixed a bug in deep links (URL), now executing the command from a terminal
open "rsyncuiapp://loadprofileandestimate?profile=AnyProfile"will open RsyncUI and execute estimate & execute for profileAnyProfile
🎨 Interface improvements
- Redesigned the sidebar as a fixed-width, 220-point panel with a flexible detail area.
- Added a dedicated toolbar button for showing and hiding the sidebar.
- Organized sidebar entries into Actions, Tools, and Management sections.
- Preserved context-sensitive Snapshot and Restore entries.
- Retained profile selection, scheduling status, version information, and notification messages.
- Removed unwanted outer padding from the main application interface while retaining padding on the startup screen.
▶️ Synchronization details
- Anchored the Synchronize play button directly to the divider between the two results tables.
- The play button now remains centered between the tables when the window is resized.
- Consolidated synchronization execution and confirmation handling.
- Preserved process ownership while canceling remaining batch tasks.
- Recorded backup success only after a successful process exit.
- Fixed synchronization countdown behavior.
♻️ Restore and snapshot fixes
- Preserved the complete restore file list while searching.
- Reset restore snapshot selection when the selected profile or restore context changes.
- Validated restore operations against the currently displayed destination.
- Fixed snapshot deletion path validation and shell quoting.
- Added restore destination, restore search, restore selection, and snapshot deletion regression tests.
🧾 Logging and storage
- Fixed Swift concurrency issues in log storage.
- Updated shared JSON storage used by RsyncUI and the widget for build 207.
- Kept profile creation errors visible until the underlying issue is resolved.
📦 Version and update information
- Updated the application version from
3.0.3to3.0.5. - Updated the application and widget build number from
201to208. - Updated the version feed so supported older releases point to the
v3.0.3download. - Added
3.0.2to the supported update-feed entries. - Updated README release information and download badges for
v3.0.3.
🧹 Repository maintenance
- Removed obsolete repository instruction files.
- Removed the old
changestr.mdchangelog file. - Simplified project documentation.
✅ Verification
- Application builds successfully with Swift 6.
- All 70 tests across 16 suites pass.
- Startup was verified using existing profiles, configurations, and schedules without triggering the previous layout crash.
Version 3.0.3
🚀 Changelog: RsyncUI 3.0.2 → 3.0.3
Status changed from release candidate -> release without a new build August 7, 2026.
Version 3.0.3 of RsyncUI exhibits a few user interface issues on the macOS Golden Gate beta. Users running RsyncUI on this beta release are advised to upgrade to version 3.0.4. This release remains in beta because it was compiled with Xcode 27 beta; a stable public release of version 3.0.4 will be issued as soon as Xcode 27 becomes publicly available.
Thanks to Tim Reichen for submitting PRs to this release. If no bugs are reported by next week, this commit will become the next official release without requiring a new build. Consequently, users who download and test it now will not receive a notification to download a new version later.
📦 RsyncUI 3.0.3
Changes since v3.0.2, through commit 6dd6322f on July 29, 2026.
✨ Improvements
- Redesigned the Add Task interface using a cleaner grouped form layout.
- Added a simpler toggle for controlling the trailing slash on source folders.
- Unified the first-task experience with the standard Add Task sheet.
- Added standard confirmation and cancellation buttons to the Add Task and Add Profile sheets.
- Updated Add Task and Add Profile toolbar controls to compact icon buttons.
- Improved the About window’s Close button and toolbar integration.
- Improved labels, field descriptions, validation borders, and browse buttons.
- Hidden the redundant inspector tab label.
- Marked delete confirmation actions as destructive for tasks, schedules, and snapshots.
- Simplified saving URLs for the RsyncUI widget.
🛠️ Fixes
- Fixed trailing-slash handling when adding and editing tasks.
- Fixed trailing-slash handling for Quick Tasks, including migration of existing preferences.
- Preserved exact configured paths instead of rewriting them during configuration validation.
- Fixed the selected task type not being refreshed when switching configurations.
- Fixed rsync itemized-output parsing for filenames containing leading spaces.
- Fixed parsing of deleted items for different rsync versions.
- Fixed placement of
--itemize-changeswhen rsync arguments contain the--option terminator. - Fixed estimation and execution states not completing correctly after process errors.
🎨 Interface Changes
- Profiles without tasks now automatically open the shared Add Task sheet.
- Task fields now use standard SwiftUI controls and grouped sections.
- The task action selector now uses a menu-style picker.
- The trailing-slash selector is now an on/off toggle focused specifically on the source folder.
- The dedicated first-task view and duplicated Add Task helper views were removed.
⚡ Quick Tasks
- Simplified the trailing-slash preference to a Boolean toggle.
- Added compatibility migration for the previous trailing-slash preference format.
- Trailing slashes are now applied only to the Quick Task source path.
- Added safeguards against duplicate trailing slashes.
- Added handling to preserve the filesystem root path correctly.
🧪 Reliability
- Added tests for itemized rsync output parsing.
- Added tests for configuration selection and task-type updates.
- Added tests for Quick Task source-path handling.
- Updated configuration validation tests for the new trailing-slash behavior.
🔧 Technical Changes
- Updated the application and widget marketing version to 3.0.3.
- Updated the build number from 196 to 201.
- Updated project targets to Swift 6.
- Updated
ParseRsyncOutputto version 1.0.1. - Removed the unused
RsyncAnalysepackage dependency. - Updated release metadata and download links for newer RsyncUI versions.
Version 3.0.2
🚀 Changelog: RsyncUI 3.0.0 → 3.0.2
This build is based on the actual Git diff from v3.0.0 to commit 64a97b8a (dated June 24, 2026).
No bugs reported, no new build
If no bugs are reported next week, this commit will become the next official release without requiring a new build. Consequently, users who download and test it now will not receive a notification to download a new version later.
📋 Improved rsync output
- Added structured presentation of itemized rsync output.
- Changes are classified as added, updated, deleted, metadata-only, or other.
- Added colored icons and clearer file paths for each change.
- Added support for both rsync and openrsync output formats.
- Automatically enables –itemize-changes during synchronization, estimation, and verification.
- Ensures the option is added only once and does not modify saved task parameters.
🗓️ More reliable scheduling
- Fixed duplicate daily and weekly schedules after recomputation or application restart.
- Improved persistence by storing schedule definitions instead of generated occurrences.
- Fixed schedule calculation across month and year boundaries.
- Schedules are now limited correctly through the end of the following month.
- Invalid, expired, and out-of-range dates are rejected.
- Prevented duplicate schedule definitions.
- Deleting the earliest schedule now correctly activates the next one.
- Deleting the final schedule clears the timer and next-schedule state.
- Improved handling and deletion of schedules missed while the Mac was asleep.
- Schedule selections are cleared after deletion.
🧹 Interface improvements
- Removed the redundant reset-selection toolbar button from the log-record view.
- Simplified itemized-output detection.
- Corrected the schedule-type picker value binding.
- Minor cleanup of the log statistics chart implementation.
✅ Testing
- Added scheduler tests covering deletion, deduplication, persistence, date validation, and year boundaries.
- Added tests for itemized rsync output parsing.
- Added tests ensuring –itemize-changes is inserted correctly and only once.
- Added a dedicated schedule test tag.
🔧 Maintenance
- Updated the application and widget version to 3.0.2 (build 196).
- Updated release and download references for the 3.0 series.
- Updated development documentation.
- Diff summary: 25 files changed, 591 insertions, and 229 deletions.

Version 3.0.0
Version 3.0.0 - May 14, 2026
Bugfix: Resolved the issue with adding tasks. Additionally, removed an annoying message regarding the missing configuration file.
The bug was caused by incorrect use of Swift concurrency in the Add function. The add and update tasks are asynchronous functions running on the @MainActor. The update was triggered by an unstructured task that completed after the caller was completed and cleared the values, causing the error.
To fix this, use structured concurrency with await. Await suspends execution until the async function completes.
Mastering Swift concurrency is challenging, and I’m learning daily. Swift concurrency and actor isolation in RsyncUI are minimized, but some model updates remain. I’m developing another app where Swift concurrency and actor isolation are essential, demonstrating mastery and highlighting areas for further learning.
Version 2.9.8
Version 2.9.8 - May 12, 2026
In this release, there are a few minor UI updates. If you prefer the update without the UI updates, please inform me, and I can create an updated version without the UI updates.
This version primarily focuses on refactoring and cleaning up the model component of RsyncUI. Additionally, there are some updates to the main Synchronize and Tasks view. There are more internal updates planned, and the next and hopefully final cleanup of the code is scheduled for June or July.
A comprehensive release notes detailing all model updates in this release is available. The detailed release notes can be accessed at the RsyncUI main repository on GitHub. The changelog is generated by AI after reviewing all Git commits and modifications to the source code.
Next version represents a substantial internal refactor, primarily focusing on enhancing the application’s codebase. RsyncUI has been in development and maintenance since late 2020, spanning over five years. It is imperative to maintain the source code’s up-to-date status to ensure the continued development and maintenance of the application. During this period, I have experienced a significant learning curve, particularly through the development of my latest application, RawCull, a culling app designed for raw files (photo app).
In the past year, artificial intelligence (AI) has emerged as an increasingly indispensable and valuable tool in the development process. For this version of RsyncUI, both GitHub’s copilot-cli and ChatGPTs codex terminal clients have proven instrumental in facilitating this cleanup effort.