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 [2019/06/14 01:22]
peternlewis
manual:Macro_Syncing [2019/06/18 01:27]
peternlewis
Line 1: Line 1:
 ====== Macro Syncing ====== ====== Macro Syncing ======
  
-Keyboard Maestro is licensed on a per user basis on up to five Macs, so if you use it on two or more Macs you may want to transfer some of your macros from one to the other. ​ You can do this by selecting the desired macros and choosing [[Menus#File_Export_Macros|Export Macros]] from the [[Menus#​File|File ​menu]] to export your macros, and then importing them on the target Mac.+Keyboard Maestro is licensed on a per user basis on up to five Macs, so if you use it on two or more Macs you may want to transfer some of your macros from one to the other. ​ You can do this by selecting the desired macros and choosing ​the [[Menus#Export_Macros|File ➤ Export Macros menu]] to export your macros, and then importing them on the target Mac.
  
 Alternatively,​ you may want (almost) all your macros on both Macs, in which case you can set up your macros to sync between them.  This means any change you make on one Mac will be mirrored on the other and vice versa, although you generally should not edit your macros simultaneously on both Macs. Alternatively,​ you may want (almost) all your macros on both Macs, in which case you can set up your macros to sync between them.  This means any change you make on one Mac will be mirrored on the other and vice versa, although you generally should not edit your macros simultaneously on both Macs.
Line 17: Line 17:
 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.
  
-On the Mac that currently has your macros, choose [[Menus#File_Start_Syncing_Macros|Start Syncing Macros]] from the [[Menus#​File|File ​menu]]. ​ Read the text carefully, and then click the BUTTON{{{Create New}}} button. ​ Save your existing macros in the macro sync file in your shared location. ​ From now on, Keyboard Maestro will sync any changes to/from that file.+On the Mac that currently has your macros, choose ​the [[Menus#Start_Syncing_Macros|File ➤ Start Syncing Macros menu]].  ​**Read the text carefully**, and then click the BUTTON{{{Create New}}} button. ​ Save your existing macros in the macro sync file in your shared location. ​ From now on, Keyboard Maestro will sync any changes to/from that file.
  
-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 ​the [[Menus#Start_Syncing_Macros|File ➤ Start Syncing Macros 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).
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#Revert_Macros|File ➤ Revert Macros 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