Cloning

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

To move between Mac and Windows (either direction)

Note you can only move the music, you can NOT move the Library (including playlists and singers)

1. copy any external music (outside the "kJams Music" folder) to a location on the new computer
2. copy the "kJams" folder from the old computer to the new computer, drop it inside the "My Music" folder. if there is a "kJams" folder already there, replace it, do not merge it
3. on the new computer, go inside the newly copied "kJams" folder, trash the "kJams Library" folder you see there (cuz it's not compatible cross platform)
4. get the "kJams ??? Serial Number.xml" (and/or ".plist") files from the old prefs folder, and copy them into the new computer's prefs folder
5. on the new computer, run kJams and Rebuild your library

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 (in kJams, go to Help menu and pick "Check for Update". If there's an error, just get the latest from the Downloads page)
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. On Windows, if you're moving from an external drive to the C drive, you should set up a virtual disk with the original drive letter, get that working, then use the symbolic link trick to move it to the C drive)
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
   2. for moving:
      1. Drag the kJams folder in the Preferences folder to the new computer, in the same place, the next steps show how
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)

If you are "moving", and you intend to keep the two computers synchronized, you must do this manually. 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.