You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[iCloud][apple-icloud] runs constantly in the background, syncing files across
4
-
devices. This utility helps you prevent this. So, how to interrupt iCloud from
5
-
syncing files or folders? It turns out that Apple maintains a blacklist of file
6
-
names and extensions that users should avoid using in their iCloud Drive. Adding
7
-
the extension `.nosync` to a file prevents iCloud from syncing that file making
8
-
it ineligible, which could be quite useful as a method of selective syncing.
9
-
You could use the same extension in a folder, but it would not stop iCloud from
10
-
sync its content, only folders that are named `tmp` or ending with `.tmp` will
11
-
not synchronize, nor their contents.
3
+
[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 No Sync:** hides and appends the appropriate extension, depending on
16
-
whether it is a file or folder, to stop the sync, then creates a symbolic
17
-
link with the same name of the original one to avoid any problems that might
18
-
occur with applications that depend on it.
8
+
<br/><br/><br/>
19
9
20
-
**iCloud Sync:** unhides the original file or folder, then it removes the
21
-
symbolic link and the extension to restart the synchronization (always
22
-
refer to the symlink to restart the sync).<br/><br/>
10
+
**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.
11
+
12
+
<br/>
13
+
14
+
**iCloud Sync:** it first unhides the original file or folder. Then, it removes the symbolic link and the extension to restart the synchronization. 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 synchronized 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 synchronization process.<br/><br/>
23
15
24
16
## Getting Started
25
17
@@ -31,23 +23,25 @@ Download the repository via curl:
31
23
sh -c "$(curl -fsSL https://raw.githubusercontent.com/nicolodiamante/icloud-nosync/HEAD/bootstrap.sh)"
32
24
```
33
25
34
-
Alternatively, clone manually:
26
+
Alternatively, you can clone the repository manually:
Once you have downloaded the repository, you can navigate into its directory in the terminal and paste the following code:
41
33
42
34
```shell
43
35
cd utils &&source install.sh
44
36
```
45
37
46
-
> The script will make a copy of the workflow files into `~/Library/Services`.
38
+
The script will make a copy of the workflow files into `~/Library/Services`.
39
+
40
+
<br/>
47
41
48
42
### Show in Quick Action Menu
49
43
50
-
Open System Preferences <ahref="#"><imgsrc="https://user-images.githubusercontent.com/48920263/113451325-0df5f380-9402-11eb-80ea-cf4140340ab4.png"draggable="false"ondragstart="returnfalse;"alt="Arrow"title="Arrow"width="5.4px" /></a> Extensions <ahref="#"><imgsrc="https://user-images.githubusercontent.com/48920263/113451325-0df5f380-9402-11eb-80ea-cf4140340ab4.png"draggable="false"ondragstart="returnfalse;"alt="Arrow"title="Arrow"width="5.4px" /></a> Select Finder then check the box:
44
+
Open System Preferences <ahref="#"><imgsrc="https://github.com/nicolodiamante/icloud-nosync/assets/48920263/1905590e-328d-4f7b-9501-2371681a648a"draggable="false"ondragstart="returnfalse;"alt="Arrow"title="Arrow"width="5.4px" /></a> Extensions <ahref="#"><imgsrc="https://github.com/nicolodiamante/icloud-nosync/assets/48920263/1905590e-328d-4f7b-9501-2371681a648a"draggable="false"ondragstart="returnfalse;"alt="Arrow"title="Arrow"width="5.4px" /></a> Select Finder then check the box:
51
45
52
46
-[x] iCloud No Sync
53
47
-[x] iCloud Sync
@@ -57,8 +51,8 @@ Open System Preferences <a href="#"><img src="https://user-images.githubusercont
57
51
1. Right-click to the file or folder you want to stop syncing to iCloud Drive.
58
52
2. Select `iCloud No Sync` from the `Quick Actions` menu to stop the sync.
59
53
3. Select `iCloud Sync` from the `Quick Actions` menu to sync it again.
@@ -67,14 +61,13 @@ Open System Preferences <a href="#"><img src="https://user-images.githubusercont
67
61
68
62
### Contribution
69
63
70
-
Please report any issues or bugs to the [issues page][issues]. Suggestions for
71
-
improvements are welcome!<br/><br/>
64
+
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].<br/><br/>
<palign="center"><ahref="https://github.com/nicolodiamante/icloud-nosync/blob/main/LICENSE.md"target="_blank"><imgsrc="https://user-images.githubusercontent.com/48920263/110947109-06ca5100-8340-11eb-99cf-8d245044b8a3.png"draggable="false"ondragstart="returnfalse;"alt="The MIT License"title="The MIT License (MIT)"width="90px" /></a></p>
70
+
<palign="center"><ahref="https://github.com/nicolodiamante/icloud-nosync/blob/main/LICENSE.md"target="_blank"><imgsrc="https://github.com/nicolodiamante/icloud-nosync/assets/48920263/957a61a7-8aba-4907-b099-97fec8bfb99a"draggable="false"ondragstart="returnfalse;"alt="The MIT License"title="The MIT License (MIT)"width="90px" /></a></p>
0 commit comments