Organize ePubs by folder and open from collections in KOReader

[SymmetryrtemmyS]

Hey everyone

I'm sure this guide will take a couple revisions to make it more clear, because it is a fairly complex installation, but this is what I've done to successfully allow my (jailbroken) Kindle to organize by file structure, including ePubs and other non-Kindle-compatible formats, organize those in Collections according to my file naming and folder structure, and open directly in KOReader, whether they were browsed manually or searched for.

A couple caveats:

• This will prevent ScreenSaverHack from showing the cover of the book that you have open, though it will still show the last screen you were on.
• This requires a jailbroken Kindle with KUAL, MRPI, and Python installed. If you are not familiar with this process or these words, refer to this thread for jailbreak instructions.
• Calibre is, if not absolutely necessary, massively helpful to have installed.
• Colons, slashes, and other 'special' characters in book titles will be converted to _ on the device. This is because of filename restrictions.

The organization I have will give you one Collection per author, and the author will be the first listed in Calibre's author-sort metadata field. A random example to show filename:

documents\Sanderson, Brandon\Mistborn - 03.10 - Mistborn_ Secret History (Jan, 2016)

Now, onto the setup instructions.

1. Download the file marked "Stable release" from this link.
2. Download the file marked "Latest Release" from this link.
3. Download the latest attachment on this post.
4. Hook the Kindle up to your computer.
5. Extract the contents of koreader-*.zip into your Kindle's root folder.
6. Open kindle-kpvbooklet-*.zip and extract the file update_kpvbooklet_*_install.bin into the folder Kindle\mrpackages
7. Open librariansync-*.tar.gz and extract the file Update_librariansync_*.bin into the folder Kindle\mrpackages
8. Eject your Kindle from your computer and unplug it, then open KUAL and go to Helper, then click on Install MR Packages. Your Kindle will reboot.
9. Reconnect your Kindle to your computer.
10. Browse to the folder Kindle\extensions\librariansync and open kindle_contents.py in Notepad or any other text editor.
11. On line 10, there is a list starting with the following line:
    SUPPORTED_EXTENSIONS = [".azw"],
12. Replace that list with the one at this link.
13. In Calibre, right-click Device, then Configure Device. Put this in the "Save template:" field:
    {author_sort:sublist(0,1,&)}/{series:|| - }{series_index:0>5.2f|| -} {title} ({pubdate})
14. Make sure that "Use sub-directories" is checked.
15. Enable ePub and all the other formats listed above, then make sure ePub is at the top of the priority list. If you have mobi or other Kindle-compatible files, they will open in the stock reader, rather than KOReader.
16. Transfer your books.
17. Eject your Kindle from your computer, then unplug it. Go to KUAL, Librarian Sync, and select Rebuild Collections (from folders).
18. You should now be done! You will need to rebuild collections whenever you add, remove, or move books.