User Tools

Site Tools


manual:Macro_Syncing

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
manual:Macro_Syncing [2017/08/23 22:59]
peternlewis
manual:Macro_Syncing [2019/06/14 01:22]
peternlewis
Line 7: Line 7:
 **NOTE: You can only sync between identical versions of Keyboard Maestro. ​ If the sync file is newer than the current version, you will be warned to upgrade, turn off syncing, or live dangerously (which temporarily disables syncing and allows you to make changes that will likely cause trouble later).** **NOTE: You can only sync between identical versions of Keyboard Maestro. ​ If the sync file is newer than the current version, you will be warned to upgrade, turn off syncing, or live dangerously (which temporarily disables syncing and allows you to make changes that will likely cause trouble later).**
  
-To do this, you need a file location that is mirrored on both Macs.  ​DropBox ​or a similar service is good for this, or you can use a shared file server, although you must ensure it is available at all times to both Macs.+To do this, you need a file location that is mirrored on both Macs.  ​Dropbox ​or a similar service is good for this, or you can use a shared file server, although you must ensure it is available at all times to both Macs.
  
 You are then ready to start syncing your macros. You are then ready to start syncing your macros.
  
-**WARNING: Syncing macros is an all or nothing affair, so any macros on the target Mac before you start syncing will be lost.**+(!) **WARNING: Syncing macros is an all or nothing affair, so any macros on the target Mac before you start syncing will be lost.**
  
-**WARNING: If you make changes on one Mac, and then make changes on the other Mac before syncing has taken place, you may lose one or other changes.** ​ Be especially careful if you are working with your Mac when offline.+(!) **WARNING: If you make changes on one Mac, and then make changes on the other Mac before syncing has taken place, you may lose one or other changes.** ​ Be especially careful if you are working with your Mac when offline.
  
 NOTE: Keyboard Maestro references to files or applications that exist on one Mac and not the other will likely cause problems, so you should ensure any application you reference on one Mac is available at the same path on both Macs. NOTE: Keyboard Maestro references to files or applications that exist on one Mac and not the other will likely cause problems, so you should ensure any application you reference on one Mac is available at the same path on both Macs.
Line 21: Line 21:
 Wait for the file to be mirrored to the second/​target Mac.  On that second Mac, choose [[Menus#​File_Start_Syncing_Macros|Start Syncing Macros]] from the [[Menus#​File|File menu]]. Again, Read the text carefully, and then click the BUTTON{{{Open Existing}}} button. Wait for the file to be mirrored to the second/​target Mac.  On that second Mac, choose [[Menus#​File_Start_Syncing_Macros|Start Syncing Macros]] from the [[Menus#​File|File menu]]. Again, Read the text carefully, and then click the BUTTON{{{Open Existing}}} button.
  
-**WARNING: All of the existing macros on this second Mac will be destroyed if you continue.** ​ If you have any macros on the second Mac that you wish to preserve, export them first, and then after syncing is enabled, import them (and they will then be synced to your other Macs).+(!) **WARNING: All of the existing macros on this second Mac will be destroyed if you continue.** ​ If you have any macros on the second Mac that you wish to preserve, export them first, and then after syncing is enabled, import them (and they will then be synced to your other Macs).
  
 Select the mirrored sync file.  Your existing macros will be replaced with the macros from your first Mac. Select the mirrored sync file.  Your existing macros will be replaced with the macros from your first Mac.
Line 29: Line 29:
 If there are some macros you do not want active on a Mac, you can configure any given Macro Group to be disabled on that particular Mac by turning on the CODE{{{Disabled on this Mac}}} setting in that Macro Group. If there are some macros you do not want active on a Mac, you can configure any given Macro Group to be disabled on that particular Mac by turning on the CODE{{{Disabled on this Mac}}} setting in that Macro Group.
  
-DropBox ​may keep backup versions, and Keyboard Maestro keeps backup revisions (in the [[Menus#​File_Revert_Macros|Revert Macros command]] in the [[Menus#​File|File menu]]), so you should be able to recover from any conflicts that happen.  ​DropBox ​may notice a conflict if you edit your macros on both Macs simultaneously. ​ As a general rule this should not be an issue, though you may lose a change if you make changes on both Macs quickly (and note that quitting the Keyboard Maestro editor is considered a change).+Dropbox ​may keep backup versions, and Keyboard Maestro keeps backup revisions (in the [[Menus#​File_Revert_Macros|Revert Macros command]] in the [[Menus#​File|File menu]]), so you should be able to recover from any conflicts that happen.  ​Dropbox ​may notice a conflict if you edit your macros on both Macs simultaneously. ​ As a general rule this should not be an issue, though you may lose a change if you make changes on both Macs quickly (and note that quitting the Keyboard Maestro editor is considered a change).
  
-Since your two Macs will likely not be identical, you may have to adjust your macros to work properly on both Macs.  Using the various [[Tokens]] and [[Calculations|functions]] can help.  For example the [[token:​MacUUID|%MacUUID%]] token is a unique ID for each Mac, and can be used to test which Mac the macro is running on.  Other functions, like the [[function:​SCREEN|SCREEN]] function can be used to ensure your macro behaves appropriately regardless of the details of the Mac.+Since your two Macs will likely not be identical, you may have to adjust your macros to work properly on both Macs.  Using the various [[Tokens]] and [[Calculations|Functions]] can help.  For example the [[token:​MacUUID|%MacUUID%]] token is a unique ID for each Mac, and can be used to test which Mac the macro is running on.  Other functions, like the [[function:​SCREEN|SCREEN]] function can be used to ensure your macro behaves appropriately regardless of the details of the Mac.
  
 Note: Only your macros are synced. ​ None of your preferences,​ clipboards or variables are synced. Note: Only your macros are synced. ​ None of your preferences,​ clipboards or variables are synced.
manual/Macro_Syncing.txt ยท Last modified: 2023/09/29 04:16 by peternlewis