Njmcq / iCloud-Control

User-controlled selective sync for iCloud Drive

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool


iCloud Control adds a menu to the Finder that allows user-controlled selective synchronisation for files stored in iCloud Drive

Important

As of February 2024, iCloud Control has been officially discontinued. I appreciate all the support and feedback from users since I took on the project. While I won't be providing further updates or support for the application, users can still utilise the latest version (1.8.1). I recommend referring to the native Finder features for iCloud synchronisation as per the iCloud Control on macOS Sonoma section. Thank you!

Installation & Help

  1. Download the latest version of iCloud Control from the GitHub releases page.
  2. Move iCloud Control from your Downloads to the Applications folder.
  3. When iCloud Control first opens, you may be prompted to enable notifications. It is highly recommended to enable notifications as they deliver important alerts when using the Publish public link feature, and if an error occurs.

Note

Notifications are currently not available on macOS High Sierra (10.13).

  1. iCloud Control will open with a window welcoming you! As per the instructions in that window, you need to select Open System Settings (or System Preferences on older versions of macOS) to bring up the Extensions panel.
  2. In the panel, select "Added Extensions" and enable iCloud Control's Finder extension (you may have to scroll down if multiple other apps appear here).
  3. Once you have done this, you can safely close System Settings/Preferences and the iCloud Control app.
  4. Open a Finder window. In the Toolbar at the top, you may see the iCloud Control icon appear. If you don't, control- or right-click the Toolbar and select "Customise Toolbar". A new window will open with a selection of Toolbar extensions. Drag iCloud Control into the Toolbar (the other extensions will be bouncing around). Some may easily confuse the default Toolbar preset at the bottom of the window for the place to drag the extension, so ensure that it's the one which has bouncing icons.
  5. Select "Done".

Having issues with the Toolbar extension?

In some circumstances, particularly if you are running an older version of macOS or have multiple versions of iCloud Control stored on your Mac, you may find that the Toolbar extension and its menus do not display correctly, or will be missing entirely. To resolve the issue, open the Apple menu and log out. You can then log back in and try again. Alternatively, restarting the Mac is basically a guaranteed solution.

Usage

The following actions are provided through a toolbar item in the Finder:

  • Remove selected items locally: the selected item(s) will be removed from your device, while remaining in iCloud.
  • Download selected items: download previously removed files from iCloud.
  • Copy public link: places a public link to the selected file in your clipboard.
  • Exclude selected items: using the .nosync file extension, files in an iCloud-based directory will not sync with the service.
  • Restore selected items: removes the .nosync extension from files, reverting them to their original file type.
  • Manage iCloud on the web: includes quick links to both iCloud.com, appleid.apple.com, and privacy.apple.com.

iCloud Control on macOS Sonoma

With the release of macOS Sonoma, iCloud Control's features have become redundant. Now, you can remove partially-downloaded folders by holding the Option key upon Control-clicking the folder, something which wasn't possible in Monterey and Ventura.

Please refer to the instructions below to learn how to leverage the native Finder functionalities for iCloud file management:

Remove selected items locally:

This can be accomplished by selecting files/folders in the Finder, Control- or right-clicking the selection, and selecting Remove Download. In a selection of files/folders with both local and cloud contents, you can hold the Option key in the menu to bring up the same action.

Download selected items:

This is available through the same Control- or right-click method as the Remove selected item locally option.

Publish public link:

This can be achieved through the Share option on macOS Ventura and later, and the Share File option in macOS Monterey and older, through the Control-click menu.

In macOS Ventura and later:

Select Collaborate from the menu, and choose Anyone with the link can edit below it (this is a little difficult to see, but it should bring up additional sharing options. Choose Anyone with the link and manage permissions as you wish. Then select Invite with Link in the Sharing options. This will copy the public link to your clipboard.

In macOS Monterey and earlier:

Once Share File has been selected, a new window will appear. Select Copy Link, and adjust the settings to Anyone with the link can edit. Manage your preferred permission settings and press Share when you are done. This will copy the public link to your clipboard.

Exclude selected items from iCloud:

Go to the Finder item in the menu bar, and select Settings (or Preferences on older versions of macOS). In the Advanced panel, enable Show all filename extensions. Then, with the files you wish to exclude, go to rename the file and add .nosync to the end of the filename.

Restore selected items:

Simply remove .nosync from the filename. Make sure to retain the original file type extension.

Compatibility

iCloud Control is compatible with macOS High Sierra (10.13) and above, and runs natively on both Intel and Apple silicon Macs. However, complete functionality is not guaranteed on some older versions of macOS, as illustrated below:

macOS High Sierra (10.13) – macOS Catalina (10.15): may have minor issues, complete functionality is not guaranteed.

macOS Big Sur (11) – macOS Sonoma (14): tested and fully compatible.

Users who wish to use iCloud Control on OS X El Capitan (10.11) or macOS Sierra (10.12) may do so with version 1.2.0 published by @Obbut, found at https://github.com/Obbut/iCloud-Control

License

View the LICENSE.md file

MIT License

Copyright (c) 2016 Robbert Brandsma
Copyright (c) 2022-2023 Nick McQuade

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

User-controlled selective sync for iCloud Drive

License:MIT License


Languages

Language:Swift 92.5%Language:Rich Text Format 7.5%