Cloning

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

To Move from Mac to Mac, or Windows to Windows, OR to backup / restore (B/R)

1. start by updating kJams to the latest version
2. If you have any music files that reside outside your ~/Music/kJams folder:
   1. for B/R
      1. back them up, making note of the full path to their original location
   2. for moving:
      1. move them to the corresponding place on the new computer
   3. Note the above MUST have the EXACT same path in their new (restored) location, as in the original location (including hard drive name / drive letter)
3. In the Finder, go to your Music folder: ~/Music/kJams/
   1. for B/R:
      1. back up this kJams folder
   2. for moving:
      1. Drag the entire "kJams" folder to your other computer, in the same place
4. run kJams on the old computer, go Help->Reveal Preferences, then quit
   1. for B/R:
      1. back up the kJams folder in the Preferences folder
5. run kJams on the NEW computer, go Help->Reveal Preferences, then quit
6. on the new computer, delete the "kJams" folder just revealed in the preferences folder
7. Drag (or restore) the preferences "kJams" folder from the old computer to the newly revealed preferences folder
8. If your user name on the new (restored) computer is (will be) 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.
9. If you have any music files on an external disk:
   1. Mount that same disc on the new (restored) computer (Windows: must have same drive letter)

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