From kJams Wiki
Jump to navigation Jump to search

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, from the user's "Music" folder, to the new computer, drop it inside the user's "Music" folder. if there is a "kJams" folder already there, replace it, do not merge it. (On Windows it will be called the "My Music" folder)
  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)

This article covers two separate topics: Moving (cloning), or Back Up and Restore (B/R). Which one you follow depends on your goal. Cloning is when you want to copy your exact setup to another computer, so you could run either one. Back Up means just copying your files to a backup folder on an external volume (not meant to be used to run kJams), and Restore means to copy FROM the backup into place on your computer such that you can then run kJams to use the restored files.

  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 (copy somewhere safe), making note of the full path to their original location. ie: where did they come from, exactly?
    2. for moving:
      1. move them to the corresponding place on the new computer. ie: on the new computer, do they appear to be in the same location as they are in the old computer? On mac, right click the original file, then hold the Option (alt) key, and pick "Copy <file> as Path Name", then paste that into your notes, that is the path. On Windows, the path is in the URL bar at the top of the window)
    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.