Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nicolodiamante/icloud-nosync

Take control of your iCloud Drive files with iCloud NoSync—the ultimate utility for effortless sync and management! Get the edge you need to stay organised and up–to–date.
https://github.com/nicolodiamante/icloud-nosync

apple apple-automator applescript automator-action automator-workflow file-management files-management finder finder-sync icloud icloud-drive icloud-sync macos nosync quick-actions quickactions sync utility utility-scripts

Last synced: about 2 months ago
JSON representation

Take control of your iCloud Drive files with iCloud NoSync—the ultimate utility for effortless sync and management! Get the edge you need to stay organised and up–to–date.

Awesome Lists containing this project

README

        




iCloud NoSync

[iCloud][apple-icloud] is a powerful utility that allows users to sync files across multiple devices. However, sometimes users may want to prevent certain files or folders from syncing. Apple has a blacklist of file names and extensions that users should avoid using in their iCloud Drive. Adding the extension .nosync to a file is a simple way to prevent iCloud from syncing that file. This technique is useful for selective syncing. However, adding the same extension to a folder will not prevent iCloud from syncing its contents. The only way to prevent an entire folder from syncing is to name it tmp or end it with .tmp.






iCloud NoSync Finder



**iCloud No Sync:** hides and appends the appropriate extension to the file or folder, effectively stopping the sync process. It then creates a symbolic link with the same name as the original file or folder to avoid any issues with applications that depend on it.


**iCloud Sync:** it first unhides the original file or folder. Then, it removes the symbolic link and the extension to restart the synchronisation. This means that iCloud Sync always refers to the symlink to restart the sync, which ensures that the latest version of the file or folder is synchronised across all your devices. By removing the symbolic link and the extension, iCloud Sync ensures that the sync is done from scratch, which reduces the chances of any errors or conflicts during the synchronisation process.

## Getting Started

### Installation

The installation process for this utility is designed for ease and convenience. You have two options:

**Automatic Installation via `curl`**: Simply execute the following command in your terminal to quickly download and seamlessly install the utility:

```shell
zsh -c "$(curl -fsSL https://raw.githubusercontent.com/nicolodiamante/icloud-nosync/HEAD/bootstrap.zsh)"
```

**Manual Installation**: If you favor manual installation, first clone the repository to your local machine using `git`:

```shell
git clone https://github.com/nicolodiamante/icloud-nosync.git
```

After cloning, navigate to the repository's directory in your terminal and execute the install script:

```shell
source utils/install.zsh
```

The script will copy the workflow files to `~/Library/Services` and then open the Privacy & Security panel.


### Show in Quick Action Menu

Once the script opens the Privacy & Security panel, select Finder and check the boxes:





Selected Quick Actions



After doing this, you should be able to right-click on files or folders in Finder and find the `iCloud No Sync` and `iCloud Sync` options in the Quick Action section of the context menu.


## How It Works

1. Right-click on the file or folder you want to stop syncing to iCloud Drive.
2. Select `iCloud No Sync` from the `Quick Actions` menu to stop the sync.
3. Select `iCloud Sync` from the `Quick Actions` menu to sync it again.






Quick Actions Menu


## Notes

### Resources

- [Apple Support][apple-guide]

### Contribution

Any suggestions or feedback you may have for improvement are welcome. If you encounter any issues or bugs, please report them to the [issues page][issues].




>



Nicolò Diamante Portfolio




MIT License

[apple-icloud]: https://www.apple.com/icloud/
[apple-guide]: https://support.apple.com/guide/mac-help/get-file-folder-and-disk-information-on-mac-mchlp1774/11.0/mac/11.0
[issues]: https://github.com/nicolodiamante/icloud-nosync/issues