KRANF KINDLE COLLECTION MANAGER (KKCM)
===============================

Usage:
  There is a video tutorial here:
     http://www.applied-mathematics.net/tools/kindleCollectionManager.html
  or on YouTube:
     http://www.youtube.com/watch?v=0aMnFdKLNP0

A complete explanation is given here:
  http://www.applied-mathematics.net/tools/kindleCollectionManager.html

Short How-to:
  1. Connect kindle to PC.
  2. Run KKCM_collections2Dir.exe program.
  3. Click Yes button
  4. Click NO in popup window where it says to "update your collections .json 
     file so it synchronizes" etc.
  5. In Documents folder on Kindle drive make whatever folders you need and 
     put books inside whatever folders they should be in.
  6. Now run KKCM_dir2Collections.exe
  7. Click OK
  8. Remove the USB cable from the Kindle 
  9. Restart the Kindle: Press the "home" button, Press the "Menu" button, 
     Select the "Settings" option, Press the "Menu" button again, Select the 
     "Restart" option. This restart-method preserves the date&time of the 
     Kindle. Other restart-methods are resetting the date&time of the Kindle 
     and are thus no longer advised (because it makes the "Most Recent First"
     list useless).

"Mobihandler" is included inside the distribution of KKCM. The software 
MobiHandler (from Alissa) allows you to see the picture cover, the author 
and the title of all your books directly inside the MSWindows File Explorer. 

Reconized files types:
  for books: *.mobi;*.prc;*.azw;*.tpz;*.asw;*.asw2;*.azw1;*.pdf;*.txt
             *.mbp;*.apnx;*.ea;*.phl
             Amazon book samples are now supported.
  for audio: *.aax;*.aa;*.mp3


How to undo the changes? (just in case)
---------------------------------------
Undo the changes made by KKCM_collections2Dir:
	replace the files in the directories they came from.
	(by default, all the files are inside the "document" folder).

Undo the changes made by KKCM_dir2Collections:
	Let's assume that the kindle drive is "G:"
	Replace the file "G:\system\collections.json" with the file
	"G:\system\YYYYMMDDhhmmss-collections.json.backup" where "YYYYMMDDhhmmss"
	is the date when the backup was made: the format is:
		YYYY: year
		MM: month
		DD: day of month
		hh: hour
		mm: minute
		ss: second

Logs:
-----

Version changes:
* v0.01: July 7, 2011: Initial release for personal usage.
* v0.02: July 9, 2011: Initial release for public use.
* v0.03: July 26, 2011: 3 additions:
    - added support for .mbp and .apnx files
    - KKCM does not "loose" anymore the assigned collection for unrecognized 
      books. If some book is not properly assigned to a collection using 
      KKCM, you can use the Kindle interface to assign the book to the 
      desired collection and KKCM won't "touch" or "loose" its collection
      settings.
    - Tentative support for .azw1 files
* v0.04: July 27, 2011: 1 addition:
   - Tentative support for .ea and .phl files
* v0.05: August 1, 2011: 1 addition:
   - prevent users to use invalid chars ("\/*<?|) into collection names
   - plus version: Possibility to Assign the same book to different Kindle collections and to Ignore specific collections.
   - plus version: Recurse in sub-directories
* v0.06: September 5, 2011: 3 additions:
   - plus version: added a user-parameter-file that allows you to change the ':' and the '>' characters to something else.
   - plus version: KKCM now keeps the order in  which the collection are displayed in the kindle (usually "last collections read" first)
   - plus version: customizable number of backup files ("maxQuantityOfBackup" parameter in "KKCM+_cfg.txt" file)
* v0.07: September 23, 2011: 1 fix, 2 additions, 1 minor change
   - Fix: last book in collection was not parsed correctly
   - the kindle drive is now detected testing if the file "/system/com.amazon.ebook.booklet.reader/reader.pref" exists
   - plus version: bookCollectionPrefix and audioCollectionPrefix 
     parameters added
* v0.08: October 11, 2011: 2 fix
   - Fix: plus version: "CollectionPrefix" parameter was not handled properly for unrecognized books (see v0.03 for more info.)
   - Fix: plus version: some "ignored" collections were not handled properly.
* v0.09: December 8, 2011: 1 minor change
   - better support for .tpz files
* v0.10: January 7, 2012: 1 fix
   - better support for multilingual kindle
* v0.11: June 4, 2012: 1 addition, 2 fixes
   - re-done completely the code that computes the hash-code of each book.
     The benefits of the new engine include:
          + a lot faster
          + more robust
          + Amazon "book samples" are now supported.
          + the "Hamster eBook converter" is now supported.
   - Fix: the "directorySeparator" parameter now accepts several chars.
     For example: you can now have "directorySeparator=, <CR/LF>" (where 
     <CR/LF> is the carriage return). This example defines a two-char
     separator: ", ".
   - Fix: the "maxQuantityOfBackup" parameter is now used (instead of 
     being fixed to a constant value: 10).
* v0.12: June 7, 2012: 1 fix
  - Fix: fixed a small glitch in the new engine that returned a false 
    hash-code in very rare occasions.
* v0.13: June 8, 2012: 1 minor change
  - changed an error message text
* v0.14: June 9, 2012: 1 minor change
  - changed compilation options to obtain faster and smaller executables
* v0.15: October 9, 2012: 1 addition, 1 fix
  - added support for *.azw3 files
  - Fix: the "bookSeparator" setting from the option file is now used properly.
