{"id":13479188,"url":"https://github.com/nicolodiamante/icloud-nosync","last_synced_at":"2025-06-15T20:37:05.904Z","repository":{"id":43921449,"uuid":"334223032","full_name":"nicolodiamante/icloud-nosync","owner":"nicolodiamante","description":"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.","archived":false,"fork":false,"pushed_at":"2024-02-03T17:25:22.000Z","size":37,"stargazers_count":113,"open_issues_count":2,"forks_count":5,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-10-30T12:48:36.197Z","etag":null,"topics":["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"],"latest_commit_sha":null,"homepage":"https://git.io/icloud-nosync","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nicolodiamante.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-29T17:59:11.000Z","updated_at":"2024-10-22T18:36:59.000Z","dependencies_parsed_at":"2022-08-24T08:21:18.416Z","dependency_job_id":"942b7d44-b1d6-4bcf-975e-0fa51393b0b6","html_url":"https://github.com/nicolodiamante/icloud-nosync","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Ficloud-nosync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Ficloud-nosync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Ficloud-nosync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicolodiamante%2Ficloud-nosync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicolodiamante","download_url":"https://codeload.github.com/nicolodiamante/icloud-nosync/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225578937,"owners_count":17491282,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2024-07-31T16:02:11.103Z","updated_at":"2024-11-20T15:01:43.603Z","avatar_url":"https://github.com/nicolodiamante.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/nicolodiamante/icloud-nosync/assets/48920263/8c37ca97-ebd7-41dd-9ce2-f362c8fedb5a\" draggable=\"false\" ondragstart=\"return false;\" alt=\"iCloud NoSync\" title=\"iCloud NoSync\" /\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/icloud-nosync/assets/48920263/7252ce73-8f3b-4d70-8168-066b610148ae\" draggable=\"false\" ondragstart=\"return false; \"alt=\"iCloud NoSync\" title=\"iCloud NoSync\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n[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.\n\n\u003cbr\u003e\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/nicolodiamante/icloud-nosync/assets/48920263/a1e57d3d-ec4d-485c-bfaa-54e4dc74e722\" draggable=\"false\" ondragstart=\"return false;\" alt=\"iCloud NoSync Finder\" title=\"iCloud NoSync Finder\" /\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/icloud-nosync/assets/48920263/79be16a5-25f2-4ec4-a503-2ba359d9adf5\" draggable=\"false\" ondragstart=\"return false; \"alt=\"iCloud NoSync Finder\" title=\"iCloud NoSync Finder\" width=\"600px\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\u003cbr\u003e\n\n**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.\n\n\u003cbr\u003e\n\n**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.\u003cbr\u003e\u003cbr\u003e\n\n## Getting Started\n\n### Installation\n\nThe installation process for this utility is designed for ease and convenience. You have two options:\n\n**Automatic Installation via `curl`**: Simply execute the following command in your terminal to quickly download and seamlessly install the utility:\n\n```shell\nzsh -c \"$(curl -fsSL https://raw.githubusercontent.com/nicolodiamante/icloud-nosync/HEAD/bootstrap.zsh)\"\n```\n\n**Manual Installation**: If you favor manual installation, first clone the repository to your local machine using `git`:\n\n```shell\ngit clone https://github.com/nicolodiamante/icloud-nosync.git\n```\n\nAfter cloning, navigate to the repository's directory in your terminal and execute the install script:\n\n```shell\nsource utils/install.zsh\n```\n\nThe script will copy the workflow files to `~/Library/Services` and then open the Privacy \u0026 Security panel.\n\n\u003cbr\u003e\n\n### Show in Quick Action Menu\n\nOnce the script opens the Privacy \u0026 Security panel, select Finder and check the boxes:\n\n\u003cbr\u003e\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/icloud-nosync/assets/48920263/5a70657b-9fbf-40b2-b0f2-ade24e2c9b6c\" draggable=\"false\" ondragstart=\"return false;\" alt=\"Selected Quick Actions\" title=\"Selected Quick Actions\" width=\"600px\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\u003cbr\u003e\n\nAfter 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.\n\n\u003cbr\u003e\n\n## How It Works\n\n1. Right-click on the file or folder you want to stop syncing to iCloud Drive.\n2. Select `iCloud No Sync` from the `Quick Actions` menu to stop the sync.\n3. Select `iCloud Sync` from the `Quick Actions` menu to sync it again.\n\n\u003cbr\u003e\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/nicolodiamante/icloud-nosync/assets/48920263/463b58e5-b7bc-4183-80d6-818b6464e23e\" draggable=\"false\" ondragstart=\"return false;\" alt=\"Quick Actions Menu\" title=\"Quick Actions Menu\" /\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/icloud-nosync/assets/48920263/ebe5533b-43c7-406a-a8b5-c9f0a2411711\" draggable=\"false\" ondragstart=\"return false; \"alt=\"Quick Actions Menu\" title=\"Quick Actions Menu\" width=\"560px\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n## Notes\n\n### Resources\n\n- [Apple Support][apple-guide]\n\n### Contribution\n\nAny 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].\n\u003cbr\u003e\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/icloud-nosync/assets/48920263/82fd2d06-9e57-47fc-8f07-8d8b5a728a97\" draggable=\"false\" ondragstart=\"return false;\" /\u003e\u003c/\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://nicolodiamante.com\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/icloud-nosync/assets/48920263/aa3768d1-9434-4a15-9d01-1b0c984ccb0f\" draggable=\"false\" ondragstart=\"return false;\" alt=\"Nicol\u0026#242; Diamante Portfolio\" title=\"Nicol\u0026#242; Diamante\" width=\"17px\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/nicolodiamante/icloud-nosync/assets/48920263/b407493d-679c-4b7a-b024-e07701700a14\" draggable=\"false\" ondragstart=\"return false;\" alt=\"MIT License\" title=\"MIT License\" /\u003e\n    \u003cimg src=\"https://github.com/nicolodiamante/icloud-nosync/assets/48920263/1c9f157c-7f5d-444f-8c73-dff70c191260\" draggable=\"false\" ondragstart=\"return false; \"alt=\"MIT License\" title=\"MIT License\" width=\"95px\" /\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003c!-- Link labels: --\u003e\n\n[apple-icloud]: https://www.apple.com/icloud/\n[apple-guide]: https://support.apple.com/guide/mac-help/get-file-folder-and-disk-information-on-mac-mchlp1774/11.0/mac/11.0\n[issues]: https://github.com/nicolodiamante/icloud-nosync/issues\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicolodiamante%2Ficloud-nosync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicolodiamante%2Ficloud-nosync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicolodiamante%2Ficloud-nosync/lists"}