Restore: Difference between revisions

From kJams Wiki
Jump to navigation Jump to search
← Older edit
No edit summary
No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
kJams keeps backups of the index ("Songs.ktd") file, so that if you run into trouble of some kind, you can restore from one of your backups.
If you have been directed here, it means that, unfortunately, you've run into a particularly nasty bug requiring that you restore from a previous backup. (i'm trying to fix this bug!)


Currently, there's no bulit-in way to do this, so here's how you do it manually.
The good news is that kJams keeps automatic backups of the index ("Songs.ktd" and/or "Songs.ksql") file, so that if you run into trouble of some kind, you easily can restore from one of your backups. (note: anywhere you see ".ktd", do the same thing if you ALSO see a ".ksql" file. In other words, if you see a file with .ksql, you delete that one too!)


# Quit kJams
# Quit kJams
# go to the "kJams Library" folder.  it is located here:<br> /Users/<you>/Music/kJams/kJams Library/...
# hold down these keys: Mac: command-opt-shift, Win: ctrl-alt-shift
# inside that folder, do you see a sub-folder called "Songs.ktd [Backups]", and it's not empty?
# while holding all those keys, launch the kJams app
## YES: I see the folder called "Songs.ktd [Backups]" (and it is NOT empty)
# Keep holding until you see the backup selection dialog. If you do not see the dialog, it means you don't have backups. Be sure to manually make backups (File menu) or turn on "Make Automatic backups" in the general prefs
### 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!)
 
### now go into that folder folder, sort by DATE, with the latest one at the top
That's it!
### find the most recent date when things were GOOD (ie: before the time when things went bad)
 
### drag that file out one level, into the "kJams Library" folder
Now select a backup, then press OK. If kJams launches and you determine that this is the good backup, you're done! Otherwise, repeat the process and pick a different one, until you find a backup that is GOOD! Interesting things to note about backups: the date, and the SIZE! (Bigger size means more song files are indexed)
### 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
### now run kJams, you should be back in business
### if you are NOT back in business, try an earlier backup
### if you ARE back in business, you may delete all backups except for the most recent, to save space
## NO: I do NOT see any folder called "Songs.ktd [Backups]", or i see it but it's EMTPY
### you were unfortunately running a version of kJams that is too old
### the only way out is to restore from a backup that YOU made: manually restore from your own backup.
### If you haven't ever made any backups, the only thing you can do is [[Rebuild|rebuild your library]]

Latest revision as of 17:44, 8 September 2023

If you have been directed here, it means that, unfortunately, you've run into a particularly nasty bug requiring that you restore from a previous backup. (i'm trying to fix this bug!)

The good news is that kJams keeps automatic backups of the index ("Songs.ktd" and/or "Songs.ksql") file, so that if you run into trouble of some kind, you easily can restore from one of your backups. (note: anywhere you see ".ktd", do the same thing if you ALSO see a ".ksql" file. In other words, if you see a file with .ksql, you delete that one too!)

  1. Quit kJams
  2. hold down these keys: Mac: command-opt-shift, Win: ctrl-alt-shift
  3. while holding all those keys, launch the kJams app
  4. Keep holding until you see the backup selection dialog. If you do not see the dialog, it means you don't have backups. Be sure to manually make backups (File menu) or turn on "Make Automatic backups" in the general prefs

That's it!

Now select a backup, then press OK. If kJams launches and you determine that this is the good backup, you're done! Otherwise, repeat the process and pick a different one, until you find a backup that is GOOD! Interesting things to note about backups: the date, and the SIZE! (Bigger size means more song files are indexed)

Retrieved from "https://karaoke.kjams.com/w/index.php?title=Restore&oldid=13212"