rsyncosx / rsyncui Goto Github PK

View Code? Open in Web Editor NEW

176.0 5.0 6.0 13.18 MB

A SwiftUI based macOS GUI for rsync.

Home Page: https://rsyncosx.github.io/RsyncOSX/

License: MIT License

Makefile 0.06% Swift 97.66% C 2.25% Rich Text Format 0.04%

rsync swiftui macos-sonoma

rsyncui's Introduction

Hi there 👋

RsyncUI and RsyncOSX are GUI´s on the Apple macOS platform for the command line tool rsync. The main difference between the two apps is how the User Interface (UI) is built. It is rsync which executes the synchronize data tasks in both apps. The GUI´s are only for organizing tasks, setting parameters to rsync and make it easier to use rsync. If you are on macOS Sonoma use RsyncUI. RsyncUI is under active development.

Install by Homebrew

Both apps might be installed by Homebrew or by direct Download. The apps are signed and notarized by Apple.

App	Homebrew	macOS	Documentation
RsyncUI	`brew install --cask rsyncui`	macOS Sonoma	rsyncui.netlify.app
RsyncOSX	`brew install --cask rsyncosx`	macOS Big Sur and later	rsyncosx.netlify.app

Why two apps and latest versions

The development of RsyncOSX commenced in 2015 as a private project to learn Swift. In 2019, Apple released SwiftUI, which is a development framework for building user interfaces for iOS, iPadOS, watchOS, TVOS, and macOS. SwiftUI quickly became very popular and I commence another private project to learn SwiftUI. The model part of RsyncOSX was at that time quite stable, and I decided to refactor the GUI by SwiftUI. And that is the short story behind the two applications.

App	Storage	#lines	#files	UI	Latest version	Version 1.0.0
RsyncUI	JSON	about 11.5k	146	SwiftUI, declarativ	v1.9.0 - 12 April 2024	6 May 2021
RsyncOSX	JSON	about 11K	121	Storyboard, imperativ	v6.8.0 - 13 April 2023	14 March 2016

There is some more info about how is RsyncUI built.

Important to verify new tasks

The UI of RsyncUI and RsyncOSX can for users who dont know rsync be difficult and complex to understand. Setting wrong parameters to rsync can result in deleted data.RsyncUI nor RsyncOSX will not stop you for doing so. That is why it is very important to execute a simulated run, a --dry-run, and verify the result before the real run.

External task executing rsync

Please be aware it is an external task not controlled by RsyncUI or RsyncOSX, which executes the command-line tool rsync. The progress and termination of the external rsync task are monitored. The user can abort the task at any time. Please let the abort finish and cleanup properly before starting a new task. It might take a few seconds. If not, the apps might become unresponsive.

RsyncUI (Swift, SwiftUI) - recommended GUI

RsyncUI is released for macOS Sonoma. Latest build is 12 April 2024.

the user guide for RsyncUI
the changelog

RsyncOSX (Swift, Storyboard) - bugfixes only

RsyncOSX is released for macOS Big Sur and later. Latest build is 13 April 2023.

the user guide for RsyncOSX
the changelog

rsyncui's People

Contributors

Stargazers

Watchers

Forkers

spuzzsomchai amgomez andreasmhahn andre-beautrait beautrait esabban

rsyncui's Issues

Fails when firstly opened "RsyncUI > Settings"

Environment

$ uname -a
Darwin pworks-laptop.local 23.0.0 Darwin Kernel Version 23.0.0: Tue Jul 18 20:35:19 PDT 2023; root:xnu-10002.0.199.505.1~3/RELEASE_ARM64_T8103 arm64

macOS 14.0 Beta (23A5301h) on MacBook Air (M1 chip)

Steps

Open RsyncUI (which is the "first-time")
Select RsyncUI from the global menu, then press Settings

Expected behavior

Opens the settings panel

Actual behavior

An error dialog appears with title The file "configurations.json" couldn't be opened because there is no such file. and message The file doesn't exist.

There is an issue when adding new tasks, the log record is not loaded after a run.

Workaround is add task(s) and restart RsyncUI. The issue is only when new tasks are added

There is a minor non critical issue when adding new tasks, the log record after a run for new task is not loaded when viewing logs. The bug is fixed and a new release will come in a week or two.

German localization for me here in Utah

I completely appreciate the work you are doing on this app. So thank you. Let me know if there is anything I can provide to help.

Window too wide for my display

I use a display that is 1200px wide, and the RsyncUI window won't fit as it's 1300px wide.

Any chance it can be made to be more adjustable?

Thanks

Unable to sync with working params

Run rsync sync via CLI, it works fine :)
Using the same parameters in RsyncUI, it never finishes sync or complains that a error happend.

Command that works via CLI but not in RsyncUI:
/usr/bin/rsync --archive --verbose --compress --delete --password-file /Users/traace/rsync-nas-pw --stats /Users/traace/Documents/ rsync://[email protected]/MP1_Storage/RSync/Studio1/Documents/

Using real rsync daemon as backend, without SSH. MP1_Storage is module location.

Issue in Update

There is an issue in the latest released dmg, the Update function of tasks was by accident deleted when cleaning the code. It is now back in code. The fix will be released as part of version 1.2.0 when macOS Monterey is released.

Progressbar, bounds not set when executing more than one task

There is one minor issue in progressbar. When executing more than one task, the bounds of progressbar is not reset (set) properly. This causes the progress not to work as expected.

A fix will be released in some days.

Older releases?

Please compile the app to be compatible with macOS 10.14+ or make your older releases available. Most people aren't running macOS Monterey yet, and don't have XCode installed either.

Big Sur

I downloaded the latest release and my Mac doesn't want to run it.

Crash if click on left menu items before end of confetti animation

Hi, I'm using this tool and I want to highlight this little issue that I have encountered.

System:

Mac mini M1 8/256 with Sonoma 14.2.1
RsyncUI 1.82
rsync 3.2.7

If I click on one of the left menù items (Synchronize, Quick Synchronize, Rsync parameters, ecc...) before the end of the confetti animation that we have during the startup, the app crashes.

If I wait, it works correctly without issues.

Dump is attached

rsyncui.log

Thank you :)

No icons in GUI

Hi,

Yesterday I test 1.7.1 and 1.7.2, is it normal that i not see any icon in GUI ?

I'm on a fresh 12.6.9.

regards,

Issues in selecting path for rsync

See the changelog. The issue is related to setting a new path for rsync.

Crash after launch

Start RsyncUI
Click anything
Get a crash report

Sometimes (1/10) it doesn't crash and works. But then it cannot sync at all (see my other issue)

RsyncUI Version 1.7.1 (83) using Ventura 13.5.2 (22G91) not working

Is anyone having issues with RsyncUI Version 1.7.1 (83) using Ventura 13.5.2 (22G91)?
In Quick Sync, I can execute a dry run but not the actual run.
Remote user and server check marks cant be selected (greyed out)
When I select menu, tasks, execute nothing happens.

No homebrew formula (yet) and status bar problem in dark mode

Hi, I really like both of your Rsync apps, and I am just exploring the new app for Monterey. Two questions upfront:

Will there be a homebrew cask just like RsyncOSX? It seems to be missing currently.
It seems to me that the status bar is very rudimentary when in dark mode - basically a blue dot growing further. Is this intended?

The blue dot also looks quite funny because it somehow "hangs down" on the right end :-) EDIT: I see, this shall become a circle, sorry for that 👍

Many thanks for this, makes rsync jobs so much better!

Just documenting for future reference: kernel panics in Monterey when using SMB shares

I just wanted to document this from the CCC website because I am also affected by this:

Apple's SMB filesystem client causes system stalls, random application crashes, and may lead to kernel panics

We have received several reports (primarily from Apple Silicon Mac users) of unruly macOS behavior that occurs while copying files to an SMB-mounted NAS volume. The behavior includes the following:

Random application crashes
Prompts to grant various macOS system services access to the login keychain (i.e. because the service that retains the unlocked keychain reference crashed, thus locking the keychain)
Laggy mouse behavior
System stalls that eventually end with a reboot and kernel panic report

Workaround: Users that reported similar trouble on macOS Big Sur reported that using AFP rather than SMB consistently resolved these behaviors

I also experience this when using rsync in Monterey, both command line and with both of your apps. So I wanted to "warn" you just in case that a user complaint comes in.

Source: https://bombich.com/kb/ccc6/macos-monterey-known-issues

Ready bo be closed after read.