K5 Collections Manager

[ixtab]

Version 2.3.6

Collections Manager offers a much more flexible way than the built-in one to manage Kindle Touch and Kindle Paperwhite collections.

Here's a screenshot of what it looks like (the second picture is annotated with descriptions):



Features:

• Nest collections inside collections
• Toggle Home Screen visibility of items
• Synchronize collections with Calibre, using NiLuJe's "Kindle Touch friendly" version of the Kindle Collections plugin
• Synchronize collections to the directory layout
• ... and more

Requirements:

• Jailbreak
• Kindlet Jailbreak (mirror: update_k5_ALL_PW_ALL_kindlet_jailbreak_install.bin from prerequisites-all-supported-devices.zip in KUAL thread)
• Developer Certificates Bundle (mirror: update_k5_ALL_PW_ALL_devcerts_install.bin from prerequisites-all-supported-devices.zip in KUAL thread)
• Kindle Touch: Firmware 5.1.0 - 5.3.2.1
• Kindle Paperwhite: Firmware 5.2.0 - 5.3.4 (Note: FW 5.3.5 is NOT supported at this time!)
• ... Other Kindle models can not and will not be supported by this software.

Installation:
Make sure that all requirements are installed; download and extract the attached file, and copy the contained CollectionsManager.azw2 to the "documents" folder on the Kindle.

Localization:

Spoiler:

Starting with version 1.1.2, this program can be localized. If you want to have the program display something else than the default english texts, download this file (right-click on the link, "Save as..." - then, if needed, edit it to suit your needs). Instructions are contained in the file itself. If you have created or updated the localization for a particular language, feel free to post it - I will update the file then.

Officially supported languages:

• english
• french (NiLuJe)
• german (diba)
• spanish (cristbo/coolpable)

The latest revision date of the official localizations is 2013-02-04.


"Unofficial" support for other languages (these must replace the english texts!):

• simplified chinese (yiming)
• traditional chinese (yiming)
• hungarian (hanog)
• persian (cscat)
• polish (yoda0)
• romanian (rorogio)
• russian (atimeofclarity)
• serbian (astmario)

Upgrade Notes:

Spoiler:

This is only relevant if you had installed version 1.x.x and are upgrading to version 2.x.x.

• The filenames have slightly changed between version 1 and version 2. Please remove all KTCollectionsManager.* files from your Kindle, and keep only the CollectionsManager.* ones.
• The filename for the localization has also changed. Similar to what was stated above, it is now CollectionsManager-localization.txt instead of KTCollectionsManager-localization.txt
• Sorry for the inconvenience.

Version history / release announcements / change log:

Spoiler:

• Version 2.3.6 (2013-03-15)
• Version 2.3.5 (2013-03-09)
• Version 2.3.4 (2013-03-06): tiny fix to 2.3.3
• Version 2.3.3 (2013-01-17)
• Version 2.3.2 (2013-01-09)
• Version 2.3.1 (2012-12-20)
• Version 2.3.0 (2012-12-19)
• Version 2.2.1 (2012-12-07)
• Version 2.2.0 (2012-11-09)
• Version 2.1.0 (2012-10-12)
• Version 2.0.0 (2012-10-09)
• Version 1.4.0 (2012-10-09)
• Version 1.3.3 (2012-08-31)
• Version 1.3.2 (2012-08-23)
• Version 1.3.1 (2012-08-17)
• Version 1.3.0 (2012-08-16)
• Version 1.2.1 (2012-08-09)
• Version 1.2.0 (2012-08-06)
• Version 1.1.2 (2012-08-01)
• Version 1.1.3 (2012-08-02)
• Version 1.1.2 (2012-08-01)
• Version 1.1.0 (2012-07-29)
  

Acknowledgements:
Special thanks to the following people:

• NiLuJe, for numerous suggestions and tips, and for the calibre plugin patch
• rorogio, for the icons
• everybody who contributed valuable feedback and suggestions
• last but not least, everybody who donated to support CM development

Notes on Calibre Synchronization:

• The Export function exports all collections which contain at least one "normal" item. However, it does not export the collection hierarchy (because Calibre does not support that).
• The Import function will never remove collections; it will only update existing collections, or create new ones (visible in home by default). In particular, this means that after deleting collections from Calibre, you may also have to manually delete these collections from the Kindle.
• Calibre Synchronization will never change the collection hierarchy, or the visibility of existing items. This applies to both import and export.

Other Notes:

• Long-tap any item to see which collections it is contained in.
• When using the "Create Collection" button, the newly created collection will be placed in the collection which is showing in the top pane.
• Collection names must be unique. In other words: you can't have two collections with the same name. If you try to create a collection with a name that already exists, or try to rename a collection so that its name would conflict with another one, the operation will silently fail.
• Fun fact: you can create infinite recursions, by including collection A in B and B in A
• To integrate Collections Manager with the GUI Launcher or KUAL, and/or to hide Collections Manager from the Home Screen, see this post. Note that the launcher script has to be edited to use the correct filename (CollectionsManager.azw2, not KTCollectionsManager.azw2).
• There is an advanced option which can change the ordering of the titles from strictly alphabetical to the way that the Kindle itself sorts by name. See this post for more information.
• On 5.1.x Firmwares, the search bar disappears if the device enters sleep mode and wakes up again. There is no known workaround, but you could just actually use the device, so that it doesn't enter sleep mode ... or simply restart the application.
• On Firmwares >= 5.2.0, the search functionality is not available.

Source code:
https://bitbucket.org/ixtab/ktcollectionsmgr/

Totally Off-Topic:

Spoiler:

Redistribution and Links:
You are free to share the Collections Manager files in whichever way you please. However, note that the links provided here are not necessarily stable. In other words: do not distribute direct download links to the files, but link to this post instead.

If you like Collections Manager:
I sincerely hope that you find this program useful. If you like the enhancements that it offers to your Kindle experience, you are more than welcome to donate a little something... but don't give your money to me. Please donate for a much more important cause, namely: for a Literacy project in Laos. You will make not only me happy. Thank you!

[Titano]

Thank YOU!!! This is exactly what I have wanted since I got my kindle. Thanks so much.

[TulseLuper]

Originally Posted by Titano

Thank YOU!!! This is exactly what I have wanted since I got my kindle. Thanks so much.

Say it´s real !!!! pleaaaaase !!!

heheheh going to test now on about 1700 itens library .

I can´t belive you Ixtab ! It´s beautifull !!

thanks !! really!!

[fefin]

Thanks you! works fine for me

[TulseLuper]

I have no words to say how up to the point you got here !

It´s perfect , even for the mostly graphic interface ! Is universal too !

wait for the amazon guys to see this heheheh ... .

Seems it is working quite smooth here , and my library is full til the neck ! Worked better than every single tool I´ve tried so far ! Congrats !

---

thinking about , it could a hint over those icos too

[dasmoover]

thank you, this is one of the most useful homebrewed feature

[ixtab]

Good to see that this is appreciated.

@TulseLuper: as to the hints, I have added a commented "help" screenshot to the first post...

Oh... woohoo! Thanks to a generous donor, I have now reached 100000 Karma!

[TulseLuper]

Originally Posted by ixtab

Good to see that this is appreciated.

@TulseLuper: as to the hints, I have added a commented "help" screenshot to the first post...

Oh... woohoo! Thanks to a generous donor, I have now reached 100000 Karma!

You deserves that !!!

Really great job ! And you got me those help screenshot! Please pack it up togheter with the azw will help a lot of people.

Now you have a trully Mayan Goddess's karma ! Namaste !

[KGS]

thanks mate

[ixtab]

(removed)

[NiLuJe]

Awesome! Would an import/export feature be doable? Preferably in the 'usual' json collection format, that would make it able to be used with the calibre kindle collections plug in with a few tweaks ;-).

I'd take a look at the sources, but the git repo is private on bb ;-).

[ixtab]

Originally Posted by NiLuJe

Awesome! Would an import/export feature be doable? Preferably in the 'usual' json collection format, that would make it able to be used with the calibre kindle collections plug in with a few tweaks ;-).

Hmmm... it sure is possible somehow. The problem is that physical entries (i.e., document files, and their sidecar entries) are an entirely different story again, and need to be treated completely differerently than collections. For instance, there is the full-text index, which indexes physical files.

While I did think about a whether a "two-way synchronization" could be done (and would have implemented it if it were sure to work), there is a reason why I only created an "import", but not an "export" feature: collections are completely "virtual", in the sense that they don't impact the file system in any way.
Providing an equivalent "export" option (sort of the "inverse function" of the import option) would modify files and directories all over the place, potentially leading to a complete misbehaviour of the Kindle (yes, I've seen it happen, by simply creating 1000 text files inside the documents folder).

Importing or exporting JSON is, of course, no problem at all. The problem is that changes to the filesystem (may) have a big impact on other components that I'm currently unable to control -- in fact, I don't even know which components are really involved.

Originally Posted by NiLuJe

I'd take a look at the sources, but the git repo is private on bb ;-).

Ooops... fixed . That was a glitch on my side, it's public now.

[NiLuJe]

@ixtab: Err, not sure I was clear enough . Let's try again:

I was thinking specifically of importing/exporting just a simple json representation of the collections db, preferably in the same format used on previous Kindles (which is, AFAIU, still used on the Touch, only meshed with a sqlite db), not of reorganizing the documents FS layout to match the collections db . But since I have no idea how the Java side of this thing works, I'm not sure if/how it's possible . I'm guessing there should be something of the sort available, since it's more or less what the 'Import Collections From Another Device' vanilla feature does, I think, albeit maybe in XML instead of JSON (cf. KSP)...

[JSWolf]

Is there any way to do this without jailbreaking?

[ixtab]

Originally Posted by JSWolf

Is there any way to do this without jailbreaking?

No.

You knew that before asking, didn't you?