Restore

From kJams Wiki
Jump to: navigation, search

If kJams has directed you here, it means that, unfortunately, you've run into a particularly nasty bug requiring that you restore from a previous backup.

The good news is that kJams keeps automatic backups of the index ("Songs.ktd") file, so that if you run into trouble of some kind, you easily can restore from one of your backups.

Currently, there's no bulit-in way to do this, so here's how you do it manually.

  1. Quit kJams
  2. go to the "kJams Library" folder. it is located here:
    /Users/<you>/Music/kJams/kJams Library/...
  3. inside that folder, do you see a sub-folder called "Songs.ktd [Backups]", and it's not empty?
    1. YES: I see the folder called "Songs.ktd [Backups]" (and it is NOT empty)
      1. NEXT to (not INSIDE of) that folder, you will see a file called "Songs.ktd". Delete it. DO NOT DELETE the folder called "Songs.ktd [Backups]" (OMG!)
      2. now go into the "Songs.ktd [Backups]" folder, sort by DATE, with the latest one at the top
      3. find the most recent date when things were GOOD (ie: before the time when things went bad)
      4. drag that file out one level, into the "kJams Library" folder
      5. rename the file so that it says "Songs.ktd". ie: if it was "Songs 73.ktd", remove the space and the 73 by renaming the file
      6. now run kJams, you should be back in business
      7. if you are NOT back in business, try an earlier backup
      8. if you ARE back in business, you may delete all backups except for the most recent, to save space
    2. NO: I do NOT see any folder called "Songs.ktd [Backups]", or i see it but it's EMTPY
      1. you were unfortunately running a version of kJams that is too old
      2. the only way out is to restore from a backup that YOU made: manually restore from your own backup.
      3. If you haven't ever made any backups, the only thing you can do is rebuild your library