Cloning

note that wherever you see the TILDE (~/) below, it means your Home folder.

To Move from Mac to Mac, or Windows to Windows

1. start by updating kJams to the latest version
2. If you have any music files that reside outside your ~/Music/kJams folder:
   1. move them to the corresponding place on the new computer. Note they must have the same path in their new location, as in the original location (including hard drive name / drive letter)
3. If you have any music files on an external disk:
   1. Mount that same disc at your destination (Windows: must have same drive letter)
4. If your user name on the new computer is different from the user name on the old one:
   1. Create a symbolic link on the new computer, with the old name, pointing to the new name. See The Symbolic Link Trick to make a shortcut / alias, or ask for help.
5. In the Finder, go to your Music folder: ~/Music/kJams/
6. Drag the entire "kJams" folder to your other computer, in the same place
7. run kJams on the old computer, go Help->Reveal Preferences, then quit
8. run kJams on the NEW computer, go Help->Reveal Preferences, then quit
9. on the new computer, delete the "kJams" folder just revealed in the preferences folder
10. Drag that entire preferences folder (the one called "kJams") from the old computer to your other computer, in the same place

You must manually keep the two synchronized. To do so, designate one as the master (where you make changes) and one as the slave (all changes to this one are overwritten by the master). Then just use a file sync tool to go from master to slave. Do NOT do a two-way sync, this will not work. On mac, you can use File Synchronization.

To move between Mac and Windows

1. copy any external music (outside the "kJams Music" folder) to a location on the new computer
2. do steps 5, 6 above
3. trash the "kJams Library" folder inside the "kJams" folder, on the new computer
4. do steps 7, 8 above
5. get the "kJams ??? Serial Number.xml" files from the old prefs folder, and copy them into the new computer's prefs folder
6. on the new computer, run kJams and Rebuild your library